Local Development And Release Flow
Understand how local development, schema export, platform bundle assembly, and CDN publication connect together.
Local Development And Release Flow
Development
The main repos are developed independently, then integrated through release metadata.
API, web, agent, platform-release, marketing, and docs repos evolve independently in local development.
Shared product behavior is reconciled through explicit refs, generated artifacts, and release metadata rather than a single monorepo package graph.
Release repos then consume those outputs into versioned artifacts and CDN manifests.
OpenAPI docs flow
noderax-apiexports a deterministic schema snapshotnoderax-docssyncs that snapshot locally- Fumadocs renders generated endpoint pages from the checked-in schema
cd noderax-api
pnpm openapi:export
cd ../noderax-docs
pnpm sync:openapiControl-plane release flow
noderax-platform-releasereadsapiRefandwebRef- it builds the platform bundle
- it publishes bundle artifacts and manifests to the CDN
- installer-managed deployments pull from the CDN latest manifest
Release surfaces by repo
API + web
Consumed by the platform bundle through explicit `apiRef` and `webRef` release metadata.
Agent
Released on its own line and surfaced to operators through fleet rollout APIs and the dashboard.
Docs
Consumes a checked-in OpenAPI snapshot and deploys as its own Cloudflare-hosted public site.
Agent release flow
The agent line is separate and consumed through rollout APIs and UI surfaces.