# Run a first ai-p1 example

Start with the smallest workflow described by the README for **ai-p1**. Complete [installation and configuration](/docs/up-to-code-ai-p1/installation-guide) first.

## 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.

## Verify your changes

The root manifest provides this check:

```sh
npm run typecheck
```

Read any errors before continuing. Build and type checks verify source consistency; exercise the README example to verify the behavior you need.

## Next task

[Read the usage guide](/docs/up-to-code-ai-p1/usage-guide) for the documented components, configuration, and source layout.

## Source and help

- [GitHub repository](https://github.com/Up-to-code/ai-p1)
- [Original README](https://github.com/Up-to-code/ai-p1/blob/main/README.md)
- [Issues and existing reports](https://github.com/Up-to-code/ai-p1/issues)