The developer documentation site for the Continuous-Driven Architecture (CDA) ecosystem — an open-source suite of libraries and tooling for working with architecture as structured, processable software artifacts.
Built with Astro + Starlight and deployed to GitHub Pages.
https://continuous-drivenarchitecture.github.io/developer-portal/
developer-portal/
├── src/content/docs/
│ ├── index.mdx # portal home
│ ├── get-started/ # CDA onboarding
│ ├── libraries/ # one section per @cda library
│ │ └── archi-semantic-core/
│ │ ├── getting-started/
│ │ ├── core-concepts/
│ │ ├── semantics/
│ │ ├── guides/
│ │ ├── compatibility/
│ │ ├── project/
│ │ └── reference/ # generated API reference (gitignored)
│ ├── architecture/ # ecosystem architecture and roadmap
│ └── contributing.md
├── src/styles/cda.css # CDA design system
└── typedoc.json # API reference generation
The source of truth for a library's public API lives in that library's repository (its JSDoc). The portal generates each library's reference from the published npm package during CI — nothing is copied by hand:
@cda/<library> published to npm
│
│ TypeDoc (typedoc.json, against node_modules)
▼
src/content/docs/libraries/<library>/reference/generated/
To regenerate locally:
npm ci
npm run gen:api
npm run dev # or npm run buildTo update the documented version of a library, bump its pinned dependency in
package.json (e.g. "@cda/archi-semantic-core": "0.4.1") and rebuild.
See Contributing.
MIT