Deployment Guide

Use this order when pushing the parent starter to production so auth, billing, and verification flows go live safely.

Recommended Production Stack

  • Vercel for app hosting
  • Supabase for authentication
  • PostgreSQL for database
  • Upstash Redis for OTP and cache flows
  • Resend for transactional email

Step 1: Add Environment Variables

Copy every required variable into your hosting provider before the first production build.

Do not forget provider-specific webhook secrets, NEXT_PUBLIC_JAMPACK_APP_URL, and monitoring variables if you are enabling them at launch.

Step 2: Run Prisma Migrations

This is especially important because organization-level billing depends on the OrganizationSubscription schema added by later migrations.

npx prisma migrate deploy

Step 3: Verify Auth and Redirects

  1. Set production redirect URLs in Supabase.
  2. Confirm / redirects to /landing.
  3. Confirm protected routes still redirect unauthenticated users to /auth/login/simple?next=....

Step 4: Configure Billing and Webhooks

  1. Replace payment IDs in config/pricing.ts.
  2. Configure one provider first.
  3. Add the production webhook URL.
  4. Test one complete success flow.
  5. Verify Prisma billing records before enabling other providers.

Step 5: Enable Optional Infrastructure

Redis should be enabled before exposing destructive delete flows in production.

  1. Resend
  2. Redis
  3. PostHog
  4. Sentry

Step 6: Run Post-Deploy QA

  1. Landing page load
  2. Signup
  3. Login
  4. Organization creation
  5. Invite send and accept
  6. Pricing checkout
  7. Webhook sync
  8. Delete verification flows
  9. Language switcher
  10. Dark and light mode