Nimbus

Nimbus

**Docs sites you own, where humans and agents are both first-class.**

Nimbus scaffolds a complete Astro documentation site into your repo — layouts, components, styles, routes, content — as real files you edit from the first commit. The invisible plumbing ships as an npm package; everything you see and shape is yours.

Docs: [nimbus-docs.com](https://nimbus-docs.com)

Quickstart

npx @cloudflare/create-nimbus-docs@latest my-docs
cd my-docs
pnpm install
pnpm dev

Open the printed URL, edit anything under `src/`, and the page reloads. You now own a full docs site.

The scaffolder asks a few questions (deploy target, package manager, starter or empty content). Skip them with `--yes`:

npx @cloudflare/create-nimbus-docs@latest my-docs --yes

Interactive runs let you pick the package manager for your project. With `--yes` it defaults to npm — add `--package-manager pnpm` (or `yarn`/`bun`) to choose another.

Everyday commands

Run these inside your project:

Command	What it does
pnpm dev	Dev server with hot reload
pnpm build	Static build to dist/
pnpm preview	Preview the built site
pnpm typecheck	Type-check (astro check)
pnpm lint:docs	Lint prose + MDX (add --fix to autofix)

Deploy

Static by default — `pnpm build` emits `dist/`, which you can host anywhere.

Cloudflare is the first-class target: the default scaffold ships a `wrangler.jsonc`.

pnpm build
pnpm run deploy      # wrangler deploy to Cloudflare

Add on demand

Pull optional components, utilities, and agent-handoff features from the registry — each lands in your repo as source you own:

pnpm dlx @cloudflare/nimbus-docs add dialog
pnpm dlx @cloudflare/nimbus-docs add 404-page

Components and utilities copy in as editable files. Features hand off a recipe your coding agent reads, adapts to your project, and applies.

What you get

• Owned source — layouts, components, content c