supabase-local-dev-loop

# Supabase Local Dev Loop ## Overview Run the full Supabase stack locally — Postgres, Auth, Storage, Realtime, Edge Functions, and Studio — using Docker and the Supabase CLI. Local development mirrors production APIs exactly, enabling offline work, fast iteration, and repeatable migration workflows. Schema changes flow through `supabase db diff` to generate migrations, and `supabase db reset` replays them cleanly. ## Prerequisites - Docker Desktop installed and running (required for all local services) - Node.js 18+ (for `npx supabase` commands) - No global install needed — all commands use `npx supabase` ## Instructions ### Step 1: Initialize Project and Start Local Stack ```bash # Initialize Supabase in your project root npx supabase init ``` This creates a `supabase/` directory: ``` supabase/ ├── config.toml # Local stack configuration (ports, auth settings) ├── migrations/ # SQL migration files (version-controlled) └── seed.sql # Seed data (runs after migrations on db reset) ``` Start the local stack (first run pulls Docker images — takes a few minutes): ```bash npx supabase start ``` The CLI prints all local endpoints and keys: ``` API URL: http://localhost:54321 GraphQL URL: http://localhost:54321/graphql/v1 S3 Storage URL: http://localhost:54321/storage/v1/s3 DB URL: postgresql://postgres:postgres@localhost:54322/postgres Studio URL: http://localhost:54323 Inbucket URL: http://localhost:5432...