Quickstart

What It Does

This quickstart gets your native app running with the required backend dependencies (apps/dashboard + local Supabase).

When To Use

• First mobile setup on a new machine.
• Verifying local environment after pulling repository updates.

Prerequisites

• Node.js >=20
• pnpm
• Docker Desktop
• Xcode (iOS) and/or Android Studio (Android), depending on your target

How To Use

Copy to Clipboardpnpm install

Copy to Clipboardpnpm run supabase:start

Copy to Clipboardcp apps/mobile/.env.test apps/mobile/.env.local

Copy to Clipboardpnpm --filter ./apps/dashboard dev

Copy to Clipboardpnpm --filter ./apps/mobile dev

Copy to Clipboardpnpm --filter ./apps/mobile ios
pnpm --filter ./apps/mobile android

Capability Map

MCP Context

Copy to Clipboardcapability: mobile_bootstrap
entrypoints:
  - apps/mobile/.env.test
  - apps/mobile/package.json
  - apps/dashboard/app/api/trpc/[trpc]/route.ts
inputs:
  - target_platform
  - local_env_values
outputs:
  - running_mobile_app
constraints:
  - apps/dashboard must run for API-backed mobile flows
  - docker is required for local supabase
side_effects:
  - starts local services and dev servers

Agent Recipe

1. Install dependencies and start Supabase from repo root.
2. Copy apps/mobile/.env.test into apps/mobile/.env.local.
3. Start apps/dashboard, then start apps/mobile and verify app boot.

Troubleshooting

• If mobile auth/data calls fail, verify EXPO_PUBLIC_DASHBOARD_URL points to running dashboard server.
• If Supabase auth fails immediately, verify EXPO_PUBLIC_SUPABASE_API_URL and anon key values.
• If Google auth fails on iOS, verify EXPO_PUBLIC_IOS_URL_SCHEMA and Supabase provider config.

Related

• Web Quickstart
• Scripts
• Database