Run a first ai-p1 example

Start with the smallest workflow described by the README for ai-p1. Complete installation and configuration 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:

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.

Verify your changes

The root manifest provides this check:

1npm 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 for the documented components, configuration, and source layout.

Source and help