Getting started
Run the example
Start the marketing site, Convex host, and performance coach Eve harness.
From the repository root:
bun installPortless assigns free backing ports and exposes stable local URLs:
| Service | URL |
|---|---|
| Marketing and documentation | https://convex-eve.localhost |
| Performance coach example | https://convex-eve-example.localhost |
| Eve development service | http://localhost:2000 |
The example app is linked to the convex-eve Convex project through its ignored apps/example/.env.local file.
To configure another machine:
cd apps/example
bunx convex dev --configure existingThe Convex action must be able to reach the Eve service, so deploy the agent or expose its development server through a public development URL. Then configure the Convex deployment:
bunx convex env set EVE_AGENT_URL https://your-eve-agent.vercel.app
bunx convex env set EVE_AGENT_TOKEN replace-with-a-long-random-valueSet the same token on the Eve deployment. Run bun run dev:convex, bun run dev:example, and bun run dev:web in separate terminals. bun run dev:eve is useful when its URL is reachable by the Convex deployment.