Reference Overview
How the reference content is generated and organized.
The reference section is generated from worker-owned OpenAPI documents.
- Dashboard API: served by TanStack Start server functions in
apps/dashboard - Public API worker export:
workers/consumer-api/src/docs/openapi.ts - Integrations API export:
packages/api-contract/src/integrations.openapi.ts - Site generation script:
apps/docs/scripts/generate-api-docs.ts
Each build writes:
- Markdown reference pages under
src/content/docs/reference/ - Raw JSON specs under
public/openapi/
This keeps the documentation site as a consumer of API definitions instead of the place where endpoint details are maintained manually.