Changelog, page 6

#64 d551fa2 Thanks @MohamedH1998! - Stop shipping the .nimbus/ build directory into scaffolded projects

.nimbus/ holds build artifacts materialized by astro build (routes.json, lint.json). It had leaked into the starter source and was being copied into new projects, so a freshly scaffolded app carried stale route and lint truth from the template rather than its own. .nimbus is now excluded by both the template-copy script and the runtime scaffolder, and removed from the starter source; a new project starts with no build artifacts and generates its own on first build.

#64 e1e4e8d Thanks @MohamedH1998! - Point the scaffolded AGENT.md at nimbus-docs check

The generated AGENT.md now documents the one-command model: a “Check it builds” row in the actions table (env + structure + authoring + types), and an “Audit this site” section that leads with nimbus-docs check --json before the manual walk of what check doesn’t cover yet (route-file existence, registry hygiene, AI surface, post-build search, Cloudflare config).

It teaches an agent the honest result contract: the primary signals are status (passed|failed|partial) and readiness (buildable|blocked|unknown), with ok kept only for back-compat; a check that couldn’t be evaluated yet (e.g. types before a build) is a note under scopes[].notes[] — never a finding, never a fix — so the fix loop terminates on status !== "failed" && summary.fixable === 0 rather than spinning on a coverage gap it cannot repair.

#55 a986d61 Thanks @MohamedH1998! - The scaffolded starter’s header now matches the Nimbus site. The mobile menu (hamburger) button moved from the left of the header to the right, alongside the theme toggle. The search trigger stays reachable on mobile: it previously used hidden sm:flex and disappeared entirely below the sm breakpoint, leaving phones with no way to search — it now renders as a compact magnifying-glass icon button on small screens and expands to the full “Search ⌘K” control from sm up (the ⌘K hint is hidden on mobile).

#55 6881e4e Thanks @MohamedH1998! - Markdown tables in the scaffolded starter now round their outer corner cells to match the table’s 0.75rem border-radius. Because the table uses border-collapse: separate, the corner cell backgrounds — most visibly the muted <thead> fill — previously kept square corners that poked past the rounded table border. The first/last <th> in the header and the first/last <td> in the last body row now carry the matching border-top-left/border-top-right/border-bottom-left/border-bottom-right radius, so the fill clips cleanly to the border. Scoped to :not([class]) authored markdown tables, so component-owned tables are untouched.

#42 8e4e210 Thanks @MohamedH1998! - Scaffolded projects now include a committed nimbus.json — a CLI-managed record of the create-nimbus-docs version, the templates-v* tag, the install root, and (as you nimbus-docs add) each installed component’s provenance. Starter components also get an API-consistency pass: type→variant on Banner/Callout, VersionPicker→VersionSwitcher, hydration moved out of inline scripts into .client.ts files via the mount() primitive, and a single getRouteFlags layout-flag helper. The scaffolded AGENT.md now documents the outdated / diff / add --overwrite upgrade flow.

#34 b8a1235 Thanks @mvvmm! - Bump for the @cloudflare/nimbus-docs minor in this release (full glob support for ignore in internal-link/image-ref) — no starter-source changes.

#32 a6491c8 Thanks @MohamedH1998! - Fix a batch of UI stress-sweep defects in the starter components:

• TOC scroll-spy no longer desyncs when a heading slugs to an empty id (e.g. an emoji-only ## 🎉). The active-heading index now stays aligned with the full link/rail set instead of a resolvable-only subset, so every section below an unresolvable heading highlights correctly.
• Mobile sidebar hamburger survives client-side navigation — the toggle re-binds on astro:page-load and tears down on astro:before-swap (via mount()), fixing a dead button after the first view transition, with the scroll lock balanced on a mid-open swap.
• Dialog content taller than the cap now scrolls inside the panel (overflow-y-auto) so the close button stays reachable.
• Banner long unbroken strings (including the framework deprecation banner’s version URL) wrap instead of overflowing.
• PackageManagers blocks with identical props on one page now get unique, incremental-build-stable DOM ids (per-page counter), fixing duplicate id/aria-controls.
• Dev-only warnings: <Steps> around a bullet list, and duplicate labels within a <Tabs syncKey> group.

#27 1ebfb6c Thanks @MohamedH1998! - Align the sidebar, add a mobile “On this page” TOC, and tighten the docs layout’s mobile and horizontal-overflow handling.

• Sidebar + TOC: the sidebar filter gains a press / to focus kbd hint and a placeholder prop; sidebar groups render an optional leading icon (from sidebar.group.icon); and a sticky native-<select> “On this page” TOC now appears under the page title on viewports below xl, where the desktop TOC rail hides.
• Mobile sidebar drawer: the drawer no longer dims or blurs the page — it slides in over a transparent overlay so the page copy stays readable, with a hairline edge instead of a shadow. Both the drawer panel and the desktop sidebar now paint their own background and contain overscroll, fixing a “no background” flash on fast/momentum scroll.
• Tabs: a tab strip wider than its column now scrolls horizontally (scrollbar hidden) instead of leaking past the page width, and the active tab is scrolled into view on activate/restore.
• Prose: long unbroken tokens (URLs, hashes) wrap within the content column via overflow-wrap: break-word instead of overflowing the page; code blocks and wide tables keep their own scroll handling.

#24 52d5a0c Thanks @MohamedH1998! - Fix scaffolded starter behavior across client-side navigations and add a 404 page.

• Re-run component initializers on astro:page-load so interactive components (code groups, dialogs, popovers, file trees, search) keep working after ClientRouter/view-transition navigations.
• Scope the search dialog’s global key handler to a module variable instead of an <html> attribute, preventing a duplicate Cmd+K handler from stacking on each navigation.
• Mark inline SVG icons with is:inline so they render reliably.
• Ship a default 404.astro page in the starter.

#20 fde68eb Thanks @MohamedH1998! - Rename to the @cloudflare npm scope

nimbus-docs → @cloudflare/nimbus-docs and create-nimbus-docs → @cloudflare/create-nimbus-docs. The unscoped packages are deprecated and receive no further releases.

Migration:

• Framework: pnpm remove nimbus-docs && pnpm add @cloudflare/nimbus-docs, then update imports — from "nimbus-docs" → from "@cloudflare/nimbus-docs" (every subpath follows: /content, /schemas, /types, /client, /markdown, /react, /lib/pkgm, /components/NimbusHead.astro). The nimbus-docs CLI bin name is unchanged.
• Scaffolder: pnpm create nimbus-docs → pnpm create @cloudflare/nimbus-docs.

No API, config, schema, or runtime behavior change — only the package names and import paths.

#16 479349b Thanks @MohamedH1998! - Templates now pin nimbus-docs 0.5.0

Scaffolds pin nimbus-docs at the minor they were generated against, so this CLI re-releases to ship templates on 0.5.0 — which drops the built-in incremental-build cache (the incrementalBuilds option, the partialResolver hook, and nimbus-docs clean). New scaffolds use a plain astro build; Astro 7’s native incremental building applies without any Nimbus opt-in.

#13 456ca74 Thanks @MohamedH1998! - Move to Astro 7

nimbus-docs now peers on astro ^7.0.0 (was >=6.4.0 <7.0.0) and builds against the Astro 7 ecosystem: @astrojs/mdx ^7, @astrojs/markdown-satteri ^0.3.4 (Sätteri ^0.9), Vite 8. The markdown pipeline — Sätteri plus the hastPlugins/mdastPlugins seam and Shiki dual-theme output — is unchanged; the Sätteri 0.6→0.9 jump left the plugin-definition types intact, so no seam code moved.

Astro 7 makes Sätteri the default processor, which unblocks opt-in server output alongside it (the gate for hosted MCP, Ask AI, and content negotiation).

Starter templates: Tailwind v4 now wires through @tailwindcss/vite instead of the PostCSS plugin, which does not build under Astro 7’s Vite 8 bundler. Scaffolded projects gain @tailwindcss/vite and drop @tailwindcss/postcss + postcss.config.mjs.

Breaking (peer): sites must be on Astro 7. The unified() escape hatch for remark/rehype plugins still works, but @astrojs/markdown-remark must now be installed explicitly (pnpm add @astrojs/markdown-remark) — pnpm does not expose it for import even though @astrojs/mdx pulls it transitively.