# Local development

### Requirements

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

Install the workspace from the repository root:

```bash
npm 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](https://github.com/Up-to-code/ai-p1/blob/main/docs/operations/setup-and-configuration.md) for the current environment contract.

Start a product surface:

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

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