Quick start

Get from zero to a running board with generation in about 15 minutes.

Prerequisites

• Node.js ≥ 22, npm ≥ 11
• Docker (for full-stack web app + Supabase)
• Optional: fal.ai API key for real image generation

Path A — Demo (no backend)

Best for exploring UI and running E2E locally without Docker.

# From your licensed source package
cd ai-saas-starter
npm install
npx nx serve demo

Open http://localhost:4200. Mock adapters simulate credits, billing, and generation.

Path B — Full stack (Supabase)

npm install
npm run db:start          # Docker Supabase stack
npm run db:reset          # migrations + seed (local only!)

Copy apps/web/src/app/supabase.settings.example.ts → supabase.settings.ts and set url + anonKey from npm run db:status (or run node scripts/write-web-supabase-settings.mjs).

npm run start:web         # Angular web on :4201

Optional: real fal generation

In supabase/functions/.env:

FAL_API_KEY=your_key
GENERATION_PROVIDER=fal

Serve Edge functions: npm run functions:serve

What to try

1. Sign up / sign in
2. Open Boards → create a board from the prompt composer
3. Watch batch variants in the studio gallery
4. Click credits in the toolbar to open plans

Next steps

• Local setup — env vars, Stripe, troubleshooting
• Commands — full command reference
• Architecture — ports & adapters