[dependabot]

Bumps @cloudflare/nimbus-docs from 0.17.0 to 0.18.1.

Release notes

Sourced from @​cloudflare/nimbus-docs's releases.

@​cloudflare/nimbus-docs@​0.18.1

Patch Changes

• #247 b98bd3f Thanks @​MohamedH1998! - - Generated _headers rules leave out any header the site's own _headers already sets for that path, site-wide rules included, so hosts no longer send doubled values such as Access-Control-Allow-Origin: *, *.

• #250 d664242 Thanks @​sansynx! - Keep application warnings visible during concurrent OpenAPI specification publication.

• #257 e9a4360 Thanks @​MohamedH1998! - - New Cloudflare projects, and nimbus-docs add adapter-cloudflare when wrangler.jsonc has no valid date, get a compatibility_date the installed Workers runtime supports instead of today's date, so local dev starts.

Changelog

Sourced from @​cloudflare/nimbus-docs's changelog.

0.18.1

Patch Changes

• #247 b98bd3f Thanks @​MohamedH1998! - - Generated _headers rules leave out any header the site's own _headers already sets for that path, site-wide rules included, so hosts no longer send doubled values such as Access-Control-Allow-Origin: *, *.

• #250 d664242 Thanks @​sansynx! - Keep application warnings visible during concurrent OpenAPI specification publication.

• #257 e9a4360 Thanks @​MohamedH1998! - - New Cloudflare projects, and nimbus-docs add adapter-cloudflare when wrangler.jsonc has no valid date, get a compatibility_date the installed Workers runtime supports instead of today's date, so local dev starts.

0.18.0

Minor Changes

• #229 a04304c Thanks @​MohamedH1998! - - A page or reusable snippet with only frontmatter builds, and its Markdown version is just its title and source.

  • A snippet included inside a list item or quote keeps that structure in the page's Markdown version.
  • llms.txt names each section for its index page's title, such as "Guides" instead of guides.
  • Documentation search results link to the page itself instead of a URL ending in #, and excerpts no longer include the page actions.
  • The Markdown version of an API page names each field as the page does, with its full coordinate beside it for citing.

• #232 d655e86 Thanks @​MohamedH1998! - - API pages link to the previous and next page in sidebar order, even when a group is collapsed.

  • Error responses start collapsed; a link to one, or to a field inside it, opens it.
  • A sidebar link to an API or docs-version mount, such as /api, no longer warns.
  • Operations that fall back to a coordinate route print one summary line, so other warnings stay visible.
  • Samples and the endpoint card keep a server URL's query after the path.
  • Response toggles meet 4.5:1 contrast in light mode, field anchors work on touch screens, and "Authorisation" reads "Authorization".

• #211 4a841cb Thanks @​MohamedH1998! - - Add bundle: false to an api entry to serve a very large or many-version API from static assets instead of the server bundle. Unchanged pages are shared across versions, and unchanged versions aren't prepared again on rebuild. Needs src/live.config.ts registering apiPagesLoader from @cloudflare/nimbus-docs/live; the build shows the snippet. The build suggests the option when an API's bundled page data passes 16 MiB.

  • Add getVersionSwitchUrl and getApiVersionHead for version pickers and heads in every rendering mode; the starter's picker and API layout use them.

• #212 94ebe52 Thanks @​MohamedH1998! - API pages show the sidebar filter. With sidebar: "on-demand" it also finds pages the sidebar hasn't loaded.

• #222 e15eea7 Thanks @​MohamedH1998! - New api[].extensions option: list the x-* fields to keep, and their values are copied onto API pages as page.extensions and field.extensions for your components to render.

• #214 825ffcf Thanks @​MohamedH1998! - API reference pages show the version picker for versioned APIs, in the sidebar and the mobile navigation.

• #211 02f53a1 Thanks @​MohamedH1998! - versionMode is now versionUrl: versionUrl: { in: "query" } selects the version with ?version= instead of ?api-version=, and old links redirect. Set param to use another name (review entry api-version-url).

• #240 381b37a Thanks @​MohamedH1998! - - og:image:width and og:image:height describe the image: generated cards stay 1200 × 630, a socialImage file in public/ is measured at build time, and any other image gets no size tags. NimbusHead takes socialImageSize to set them for an image Nimbus can't measure.

  • The sitemap has <lastmod> on every documentation page, from frontmatter lastUpdated or the page's last commit, and /sitemap.xml is a copy of sitemap-index.xml unless the site serves its own.
  • The starter's BaseLayout passes socialImageSize through to NimbusHead, and the 404 page recipe writes the new title and noindex.
  • On a shallow clone, pages get no git dates instead of the wrong one, and the build says how to fetch the history.
  • The 404 page's title is Page not found | <site> and the page is noindex.

• #233 1f2ce43 Thanks @​MohamedH1998! - - New sites open content images at full size on click. On an existing site, run nimbus-docs add image-zoom and render <ImageZoom /> in src/layouts/DocsLayout.astro.

• #238 315ab66 Thanks @​MohamedH1998! - - A resource-action-v2 route convention publishes tag pages at lowercase URLs, such as /api/tags/user-management, with the same operation URLs as resource-action-v1. Existing conventions, and sites without routes, are unchanged.

  • The API reference recipe sets resource-action-v2 on new sites and resolves the route collisions the build reports.

• #224 79b05ef Thanks @​MohamedH1998! - - New markdown.features option turns on Sätteri syntax, such as { headingAttributes: true } for ## Install {#install} or { math: true }. Pages, generated Markdown, reusable snippets and lint all follow it. New sites start with heading ids on.

... (truncated)

Commits

• 482054f chore: bump package versions
• a27cf79 Revert "feat: build one collection or a set with NIMBUS_BUILD_ONLY"
• 9279e8d Revert "fix: upgrade safety: add --overwrite without a terminal, sharp on pnp...
• e9a4360 fix: write a compatibility date the local workers runtime supports
• 27fa6b1 Merge pull request #242 from cloudflare/fix/upgrade-safety
• d664242 Preserve warnings during concurrent spec publication
• d2a08f2 fix: slice search results resolve from the site root, and the root llms.txt n...
• 23291af test: compare the root sitemap url exactly
• 88b3265 fix: keep a site's own .well-known files in a slice
• 3c484e0 test: accept the date every route truth carries
• Additional commits viewable in compare view

[cloudflare-docs-bot]

Dependabot review

✅ Merge + verify · 1 package · 0 breaking · 0 security · 2 to check

Fixes plus additive features; sitemap and headers output changed — verify after merge.

Before merging

• @cloudflare/nimbus-docs: Verify sitemap.xml lastmod values in a production build · /sitemap-index.xml
• @cloudflare/nimbus-docs: Confirm /.well-known/agent-skills/* CORS header is single, not doubled · public/_headers, deployed Worker

Package	Bump	Risk	Why
@cloudflare/nimbus-docs	0.17.0 → 0.18.1 · minor	🟢 low	Fixes and additive features; no used API breaking

Details

@cloudflare/nimbus-docs 0.17.0 → 0.18.1

Change	Kind	Affects us?
_headers dedup: generated rules skip headers site already sets (#247)	🐛 fix	Yes: public/_headers workaround for doubled CORS on /.well-known/agent-skills/*
Built-in sitemap lastmod from frontmatter/git; custom serializer removed (#240)	🔀 behavior	Yes: astro.config.ts migrated in this PR
Markdown/llms generation: frontmatter-only pages, snippet structure, llms.txt titles (#229)	🐛 fix	Yes: llms-full.txt and index.md endpoints
versionMode renamed versionUrl; getVersionSwitchUrl/getApiVersionHead added (#211)	✨ feature	No: versionMode/versionUrl unused
API page additions: picker, filter, extensions, resource-action-v2 (#212 #214 #222 #238)	✨ feature	No: nimbus API pages not used (served elsewhere)

Used in: package.json, astro.config.ts, public/_headers

[cloudflare-workers-and-pages]

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://dependabot-npm-and-yarn-cloudflare-nimbus-docs.previews.developers.cloudflare.com (commit 5863f4a)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status	Deployment URL	Commit	Updated (UTC)	See this deployment's details
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://6d9bc4f0.previews.developers.cloudflare.com	5863f4a	2026-10-19T15:23:57.892Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://dbc70801.previews.developers.cloudflare.com	cbc6a02	2026-10-15T05:34:32.922Z	Visit the dashboard ↗
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://c35bff49.previews.developers.cloudflare.com	911b3e2	2026-10-14T19:02:16.272Z	Visit the dashboard ↗

[github-actions]

Worker Preview URL: https://gh-dependabot-npm-and-yarn-cloudflare-nimbus-do.previews.developers.cloudflare.com
Worker Preview Deployment URL: https://47083dbc.previews.developers.cloudflare.com

[mvvmm]

closed in favor of #34449

[dependabot]

OK, I won't notify you again about this release, but will get in touch when a new version is available. If you'd rather skip all updates until the next major or minor version, let me know by commenting @dependabot ignore this major version or @dependabot ignore this minor version. You can also ignore all major, minor, or patch releases for a dependency by adding an ignore condition with the desired update_types to your config file.

If you change your mind, just re-open this PR and I'll resolve any conflicts on it.