Guides
Use and adapt partners
Use and adapt partners: A standalone developer portal for Anan partner authorization apps, with its own Convex data and authentication.
Use the documented interfaces and source layout for partners. The sections below retain the README’s examples and configuration details.
Local Development
- Default local URL:
http://localhost:3002 pnpm --filter ./partners devstarts on3002, or the next open port when3002is busy./signupcreates a Partner Programmer account and a programmer organization for app review work./dashboard/accountmanages the developer profile and programmer organization.pnpm --filter ./partners convex:devruns the Partners Convex backend.
Portal Architecture
server/repositories are the boundary for server-side Convex calls.hooks/contains client hooks for account, organization, avatar, app form, and access checkpoint state.stores/contains Zustand UI stores for portal chrome, account snapshots, and app permission checkpoints.types/,utilities/, andvalidation/hold shared contracts, pure helpers, and Zod schemas.security/,trust/, andrate-limits/are only used where runtime wrappers need production checks, trusted auth headers, or sensitive-route throttling.
Commands in the root manifest
The captured package.json declares the following scripts. Run them from the directory containing that manifest.
| Command | Script |
|---|---|
npm run dev | node scripts/dev-next.mjs |
npm run build | next build |
npm run test | vitest run |
npm run typecheck | tsc --noEmit |
npm run start | next start --port 3002 |
Troubleshoot a local change
- Reproduce the smallest example from the quick-start guide.
- Compare required configuration and dependency versions with the README.
- Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.
Source and help
Source captured: 2026-10-11
