Introduction

Nimbus docs are a static site. Markdown files in this repository are compiled by Astro Starlight into HTML, and the result is uploaded to Cloudflare Workers as static assets. There is no database, no admin panel and no runtime to patch.

The three moving parts

Layer	What lives there	Who touches it
Content	src/content/docs/**/*.{md,mdx}	writers, via pull request
Theme	src/styles/custom.css, src/components/*	front-end
Delivery	wrangler.jsonc, .github/workflows/*	platform

Why this shape

• Review is built in. A typo fix and a code change follow the same path: branch, PR, review, merge.
• Nothing can drift. What is in main is exactly what is live; a deploy is a build of a commit.
• Rollback is cheap. Every deploy is an immutable Worker version — roll back in seconds.
• Cost is flat. Static assets are served from cache; the bill does not move with traffic.

Already have docs elsewhere?

Migrating is mostly a git mv and a link rewrite. See Deploying for the redirect file that keeps old URLs alive.

Where to go next

• Installation — get the site running locally.
• Quickstart — publish your first page.
• Writing docs — frontmatter, components, links, style.