The Calimero Core documentation site, built with Astro Starlight and published to https://calimero-network.github.io/core/.
- Astro Starlight shell — sidebar, built-in search, dark/light, responsive.
- The Calimero theme (light and dark) ported into Starlight tokens (
src/styles/theme.css). - MDX authoring — content as Markdown, diffs cleanly in PRs.
- A bespoke animated-SVG diagram engine mounted as an Astro island
(
src/components/SeqDiagram.astro) for sequences, and hand-authored structural diagrams insrc/components/diagrams/wrapped inFigure; both follow the light and dark themes through the palette insrc/styles/theme.css.
cd docs
npm install
npm run dev # http://localhost:4321/core/
npm run build # static output in dist/
npm run check # astro build + internal link check (what CI runs)Pages live in src/content/docs/, split by audience track — Cloud (overview,
quickstart and writing apps), Build, Operate, Protocol Reference, and
Contribute. The sidebar is listed by hand in astro.config.mjs. See
src/content/docs/contribute/docs.mdx for the authoring guide.