Supabase Setup

Purpose: Configure Supabase locally and link to your project. Audience: Developer, Owner Prerequisites: Supabase account and CLI installed.

CLI basics

• Install: npm i -g supabase
• Login: supabase login
• Link project: supabase link --project-ref YOUR_SUPABASE_PROJECT_REF
• Start local: supabase start

Migrations and schema

• Remote schema snapshot: supabase/backups/remote-schema.sql (reference only).
• Migrations directory: supabase/migrations/ (apply with CLI as needed).
• Seed: supabase/seed.sql or supabase/seed.full.sql.

Edge Functions

• Directory: supabase/functions/*
• Deploy: supabase functions deploy <name>
• Example: Webhooks handler in supabase/functions/stripe-webhook/index.ts uses STRIPE_SECRET_KEY, SUPABASE_SERVICE_ROLE_KEY (server-side only).

Local dev with Vite

• Proxy functions: vite.config.ts:12-17 maps /functions/v1 to 127.0.0.1:54321.
• Use .env for Vite vars and Supabase publishable key (redacted).

Redaction

• Replace real values with placeholders in docs (e.g., YOUR_SUPABASE_PROJECT_REF).

Next steps

• See docs/data-model/schema.md for discovered tables and RPCs.
• See docs/operations/deployment.md for production rollout.