Local development

Requirements

• Node.js 22 or later
• npm
• Service credentials for the application surface being run

Install the workspace from the repository root:

1npm ci

Copy only the relevant committed environment examples and provide local values. Do not commit .env files, credentials, production identifiers, or customer data. See setup and configuration for the current environment contract.

Start a product surface:

1npm run dev:ws                  # Workspace web app and Convex development runtime
2npm run dev:workspace:desktop   # Workspace desktop development shell
3npm run dev:marketing           # Marketing site on port 3005
4npm run dev:mobile              # Expo mobile development server
5npm run dev:zapier              # Zapier integration development server

apps/partners is a retained static surface rather than an executable npm workspace.