Deployment Checklist

Use this checklist when promoting to production. It covers both the Next.js app (npm run build:app) and the docs site (documentation/), plus Supabase considerations.

1. Preflight

• npm install (ensure dependencies like tsx exist).
• npm run lint && npm run test.
• npm run build:test (runs smoke build script).
• npm run e2e (optional for critical releases).
• cd documentation && npm run build.

2. Supabase

• supabase db push (if new migrations).
• Run npm run db:gen to refresh types.
• Verify RLS policies via dashboard or SQL (SELECT * FROM pg_policies WHERE schemaname='public';).
• Update .env.production with new env vars (Stripe, Resend, AI providers).

3. Vercel

• App deploy: vercel --prod (root).
• Docs deploy: cd documentation && vercel --prod (if hosting separately).
• Confirm environment variables in Vercel dashboard (Production + Preview) match .env.

4. Post-deploy

• Hit health endpoints or check Vercel/Supabase logs.
• Validate key pages (/pricing, /store, /blog, /chat).
• Confirm webhooks (Stripe/Resend) still receive events.
• Monitor Mixpanel + GA dashboards for anomalies.

Keep this checklist updated as the deployment pipeline evolves (CI/CD, multi-region, etc.).

Related Documents

• Setup Overview - Complete setup before deployment
• Environment Variables - Configure production environment variables
• Testing - Testing guide before deployment
• Performance - Performance optimization before going live