Setup Guide

This page summarizes the recommended launch path: Supabase Cloud for database and Vercel for hosting.

Required Path

Supabase Dev + Supabase Prod

  1. Create two Supabase projects: one for Dev, one for Prod.
  2. Run npm run setup:first-run.
  3. Set DATABASE_URL in .env to your Dev Supabase DB.
  4. Set Vercel DATABASE_URL to your Prod Supabase DB.

Full guides: docs/public/database.md and docs/public/deployment.md

Safety Rules

Do Not Mix Environments

  1. Never put Prod DB credentials in local .env.
  2. Never put Dev DB credentials in Vercel production env.
  3. Test migrations on Dev before deploying to Prod.

Full guide: docs/public/database.md

Quick commands

npm run setup:first-run
npm run db:init
npm run db:migrate:dev