Quickstart

What It Does

This quickstart gets you from dependency install to running app(s) with local Supabase.

When To Use

• First local run.
• Verifying environment after pulling updates.

Prerequisites

• Node.js >=20
• pnpm
• Docker Desktop

How To Use

Copy to Clipboardpnpm install

Copy to Clipboardpnpm run db:generate
pnpm run supabase:start

Copy to Clipboardcp apps/dashboard/.env.test apps/dashboard/.env.local
cp apps/marketing/.env.test apps/marketing/.env.local

Copy to Clipboardpnpm --filter ./apps/dashboard dev
# or
pnpm --filter ./apps/marketing dev

Capability Map

MCP Context

Copy to Clipboardcapability: bootstrap_project
entrypoints:
  - package.json scripts
  - apps/*/.env.test
inputs:
  - selected_app
outputs:
  - running_local_app
constraints:
  - docker required for local supabase
  - app env vars must be present
side_effects:
  - installs dependencies
  - starts local services

Agent Recipe

1. Run install and DB bootstrap commands from root.
2. Copy the relevant .env.test to .env.local.
3. Start one app with workspace filtering and validate route load.

Troubleshooting

• If auth/database routes fail, confirm Supabase is running (pnpm run supabase:start).
• If build fails on missing envs, compare .env.local against envs.ts in that app.

Related

• Configuration
• Deployment
• MCP Capabilities