Getting started

Use this flow when you first open the SigmaNext source. Adjust commands if your repo uses pnpm or bun.

1. Install dependencies

npm install

2. Environment file

Copy .env.example to .env.local (Next.js) or the path your app loads. Fill minimum vars to boot — see Environment & secrets.

3. Database

Create a Postgres database (local Docker or Neon). Run migrations before first run:

npm run db:migrate

Details: Database & Drizzle.

4. Development server

npm run dev

Open http://localhost:3000 (or the port shown).

5. Production-minded checklist

  • Stripe webhooks point to your public URL (use Stripe CLI locally).
  • Never use sk_live_ keys in development .env committed to git.
  • Use separate databases for staging and production.
Single-product modeIf you are not shipping multi-tenant SaaS, you can run a single default organization and hide or simplify billing — the codebase is modular; trim routes and nav after you understand the auth + org boundary.