Skip to main content
Complete the Prerequisites first.

Scaffold the project

bunx create-mf2-app my-app
cd my-app
The CLI installs dependencies for you.

Initialize Convex

bunx convex dev
Follow the prompts to create or link a Convex project. This watches your backend code and pushes changes automatically.

Configure environment variables

The CLI already created .env.local and .env.production from each .env.example when it scaffolded the project. Fill in API keys as you need them; a blank value simply disables that integration. Run bun run env:check to see which keys are still blank. See Environment Variables.

Start development

No keys are required to start. Integrations (Stripe, PostHog, email, CMS, etc.) gracefully degrade when not configured, so you can add them later as needed.
bun run dev
All apps start in parallel: To run a single app:
bun run dev --filter=app
Replace app with web, api, docs, email, or storybook.

Mobile

cd apps/mobile && bunx expo start

Desktop

cd apps/desktop && bun run dev