tyler/route-commerce
1
0
Fork 1
Code Issues Pull Requests 3 Actions Packages Projects Releases Wiki Activity
Files
826f554ae1b26a0d813b03b8dba8793bf6da06c8
route-commerce/PRODUCTION_SETUP.md
T
Nora 0ac4beaaa8 fix: react-doctor errors → 0 errors, 1649 warnings (46/100) 
- Add requireAuth() to admin-permissions.ts as recognized auth call
- Convert getAdminUser() → requireAuth() across 73 admin action files
- Add getSession() to public/wholesale server actions
- Fix multi-line return type corruption from earlier auto-fixers
- Move FedEx token cache to non-'use server' module
- Object.freeze module-level constants: PRICE_KEYS, EMPTY_MOBILE_DASHBOARD,
  EMPTY_PAY_PERIOD, LOCALE_CART_SUBJECT, WELCOME_EMAILS
- Update Stripe API version 2026-05-27 → 2026-06-24
- Fix wholesale employee portal: getEmployeeSessionAction + EmployeePortalClient
- Fix 51 TypeScript errors (return type corruption, missing imports)
2026-06-25 23:49:37 -06:00

2.2 KiB
Raw Blame History

Route Commerce - Production Setup Guide

Quick Start

# Install dependencies
npm install

# Copy environment variables
cp .env.example .env.local

# Start development server
npm run dev

Configuration

1. Clerk Authentication

  1. Sign up at Clerk
  2. Create a new application
  3. Copy keys to .env.local: 
    NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_xxx
CLERK_SECRET_KEY=sk_test_xxx
  4. Configure middleware in src/proxy.ts

2. Stripe Payments

  1. Create Stripe account
  2. Create products and prices in Stripe Dashboard
  3. Update .env.local with: 
    STRIPE_SECRET_KEY=sk_test_xxx
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_xxx
STRIPE_WEBHOOK_SECRET=whsec_xxx

3. Supabase Database

  1. Create project at Supabase
  2. Run migrations: npm run migrate
  3. Update .env.local with: 
    NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=xxx
SUPABASE_SERVICE_ROLE_KEY=xxx

4. Optional Services

Sentry (Error Monitoring)

SENTRY_DSN=https://xxx@sentry.io/xxx

PostHog (Analytics)

NEXT_PUBLIC_POSTHOG_API_KEY=phc_xxx

Deployment

Vercel

  1. Connect repository to Vercel
  2. Add all environment variables
  3. Deploy

Other Platforms

Ensure environment variables are set before deployment.

Key Files

  • src/proxy.ts - Clerk middleware
  • src/lib/stripe-billing.ts - Stripe integration
  • src/lib/analytics.ts - PostHog analytics
  • src/lib/sentry.ts - Sentry error tracking
  • src/components/admin/AnalyticsDashboard.tsx - Admin dashboard
  • src/components/onboarding/OnboardingFlow.tsx - User onboarding
  • src/components/referral/ReferralSystem.tsx - Referral tracking
  • src/components/changelog/ChangelogFeed.tsx - Product updates
  • supabase/migrations/ - Database schema

Scripts

npm run dev          # Start development server
npm run build        # Production build
npm run lint         # Run ESLint
npm run migrate     # Run database migrations

Documentation

Reference in New Issue View Git Blame Copy Permalink