cloudflare/nimbus @cloudflare/nimbus-docs@0.19.0

@cloudflare/nimbus-docs@0.19.0

Repository: cloudflare/nimbus

Tag: @cloudflare/nimbus-docs@0.19.0

Published: 2026-10-22T23:00:15Z

Prerelease: no

Release notes:

Minor Changes

• #265 `2440889` Thanks @MohamedH1998! - - agents: { discovery: false } leaves origin-root agent discovery to the site that owns the domain: no /.well-known/ard.json, ai-catalog.json or api-catalog, no rel="ard" or rel="api-catalog" homepage links, and your own .well-known files are kept.

• #283 `ed581a0` Thanks @MohamedH1998! - - An API reference can be the whole site: a route at src/pages/[...slug].astro serves the API collection at the root. Every URL Nimbus builds for it is root-relative: pages, the version picker, the sidebar, breadcrumbs, Markdown versions, llms.txt, the sitemap, openapi.json and the API catalog.
• A site whose content.config.ts declares no docs collection no longer queries one for the sidebar, so Astro's "collection does not exist" warning is gone. A sidebar that names docs still queries it.

• #273 `352a245` Thanks @MohamedH1998! - A redesigned API reference:

• The API home lists every endpoint, grouped by x-tagGroups, with a filter; large specs load in parts as you scroll. The API route serves the later parts at /api/index/2/ and on, noindex and left out of the sitemap and search; it takes the part size as homeChunkSize in both getApiStaticPaths and getApiRoute (without it, the home is one page), and getApiRoute returns the parts as home.
• Section pages list their endpoints name first, with the method and path beneath.
• The API version picker sits in the header, at every width.
• Code rail lines sit on whole pixels, with quieter line numbers; section titles are in full ink.
• The API sidebar's rows match the docs sidebar's.
• Section page operations gain method, path, description and deprecated, and the root page gains an index of every endpoint.
• getApiRoot reads an API version's root page from any route; chunkApiIndex and apiIndexRows split and flatten its index.

nimbus-docs migrate lists the optional steps to adopt it.

• #274 `961e85d` Thanks @MohamedH1998! - - New sites' share cards show the site's logo, the page's section and its title, on white. A long title shrinks before it's cut and stays within three lines.
• The card's look lives in the site's src/pages/og/_card.ts; the logo is drawn once, in src/components/logo.ts, for the header and the cards.
• @cloudflare/nimbus-docs/og fits text by measuring it and renders cards to PNG. It needs satori and @resvg/resvg-js, optional peers.
• getPageSection(page) returns the label of a page's nearest parent, from the sidebar for docs pages and from the spec for API pages.

• #274 `91eb2e9` Thanks @MohamedH1998! - - Card takes href: the whole card becomes the link.
• Diagram buttons and controls keep their 32px height inside prose.
• PUT and PATCH method chips meet 4.5:1 contrast in light mode.
• The version picker and the API field toggle are named by their visible text.

• #288 `aafc259` Thanks @MohamedH1998! - - docsCollection({ markdownFields }) writes the named frontmatter fields into each page's .md and .mdx.
• NestedContent shows another page's content inside this one, its headings below yours and its section links pointing back to its page.
• nimbus-docs add changelog builds release notes: 10 releases a page, a page per release, and an @astrojs/rss feed. Existing changelogs keep working (review entry changelog-release-notes).

• #267 `eb1a3a6` Thanks @MohamedH1998! - - A collection is served where its route file is: src/pages/products/sdk/[...slug].astro serves sdk at /products/sdk, and every URL Nimbus builds follows: pages, sidebar, Markdown versions, llms.txt, sitemap, search, social cards, and for an API its versions, openapi.json and catalog entry. Sites whose route folders match their collection names build the same output.
• getCollectionUrl(collection) returns where a collection is served, for links in components. A name that isn't a page collection throws.
• nimbus-docs check lists where each collection is served when a route moves one; check --json always includes it.
• Sites that build broken URLs today now fail with an error naming the file and the fix: several routes for one collection with none at its default URL, two collections on one URL, a collection served only from dynamic folders, a docs or version route away from its URL, a page under another collection's moved URL, a route helper in a route whose parameter isn't slug ([...path].astro), or a route helper running in a route its collection isn't served from.
• A sidebar prefix for a collection served by a route helper is deprecated: the route sets the URL.
• getIndexedTopLevel() groups a moved collection under its URL: a group's slug and label can contain / (products/sdk). Components that build /${slug}/llms.txt or show label should expect it.
• Two new warnings, from the build and check: a second static route for a collection that's already served elsewhere (its pages duplicate the collection's), and a helper route in a nested folder whose getStaticPaths Nimbus can't read.
• nimbus-docs lint follows the pages Astro writes for a...