Local setup

Web app configuration

Create apps/web/src/app/supabase.settings.ts from the example file:

export const webSupabaseSettings = {
  url: 'http://127.0.0.1:54321',
  anonKey: '<from supabase status>',
  billingProvider: 'mock', // or 'stripe' | 'custom'
  // requireEmailConfirmation defaults to true (matches config.toml)
};

Supabase

Never run db:reset on shared or production databases.

Studio is available at the URL printed by db:status.

Edge Functions

Environment file: supabase/functions/.env

GENERATION_PROVIDER=mock
# FAL_API_KEY=...        # optional
# GENERATION_WEBHOOK_SECRET=...  # production webhooks

Serve locally: npm run functions:serve

Self-serve billing (mock checkout)

Migration 0043 gates update_organization_plan behind private.platform_settings.self_serve_billing.

Local supabase db reset enables it via seed. Do not enable on production — use verified billing webhooks instead. See Custom billing provider.

Common issues