[renovate]

Note

This PR body was truncated due to platform limits.

This PR contains the following updates:

Package	Change	Age	Confidence
@cloudflare/nimbus-docs (source)	^0.11.0 → ^0.18.0

---

Release Notes

cloudflare/nimbus (@​cloudflare/nimbus-docs)

v0.18.1

Compare Source

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.

v0.18.0

Compare Source

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.

  • Generated Markdown drops {/* comments */}.
  • Invalid MDX reports the file, line and fix instead of an internal error.

• #​226 dd95e97 Thanks @​MohamedH1998! - - New math() Markdown plugin typesets $…$, $$…$$ and ```math at build time as native MathML, with no math JavaScript. Add math() to markdown.hastPlugins and math: true to markdown.features to use it.

• #​236 fb759c5 Thanks @​MohamedH1998! - - With the section route at src/pages/[...section]/llms.txt.ts, each sub-folder gets its own llms.txt, and its parent's index links to it under "Sections". New sites have this route; a [section] route keeps today's one index per top-level section.

  • An llms-full.txt over 25 MiB becomes an index of one llms-full.txt per section, split further where a section is still too big, so the site deploys to Cloudflare.
  • LlmsEndpointReference (from @cloudflare/nimbus-docs/agent-endpoints) adds surface: "full" on section references, for the per-section llms-full.txt files.

• #​224 79b05ef Thanks @​MohamedH1998! - Starter fixes:

  • The theme toggle no longer submits a surrounding form, reports its state to screen readers, and still switches when storage is blocked.
  • Closing a dialog no longer releases another overlay's scroll lock.
  • "Copy page" works in Safari, and a failed command copy shows it failed.
  • In search, Enter on the close button closes the dialog, and status messages are announced.
  • <Render> params can't replace registered components; small fixes to breadcrumbs and the mobile table of contents.
  • Banner content is rendered as written, like the rest of the site's content.

• #​223 c39fdfc Thanks @​MohamedH1998! - The docs version picker no longer appears on pages outside the docs versions, such as API reference and blog pages.

Patch Changes

• #​228 6d4bd68 Thanks @​MohamedH1998! - - add reports components whose files already match the registry as up to date, and --overwrite lists each file it replaces, asking first in a terminal when you've edited the component.

  • add --overwrite detects edits to components that came with the starter from the starter release your site came from, so it replaces untouched ones without asking.
  • add adds a component's missing files even when it keeps your edited ones, and lists each file it adds, replaces or keeps.
  • add no longer suggests registering a component that components.ts already registers.
  • Upgrade reviews about API reference pages are skipped on sites without an API collection.
  • outdated says when a newer Nimbus is out, when the reviewed version only needs recording, and when a registry dependency is installed below the version a component needs.
  • diff --apply on a file only you changed reports there's nothing to pull, without failing.
  • diff, outdated and migrate explain preview builds instead of asking for a baseline.

• #​219 942c57b Thanks @​MohamedH1998! - Generated code samples for multipart/form-data request bodies now send every part, with file fields as <name> placeholders, instead of only the Content-Type header.

• #​223 c39fdfc Thanks @​MohamedH1998! - - Generated API samples use <base-url> when a spec has no server or a relative one, instead of an invented host, and fill server variables from their defaults.

  • OpenAPI 3.2 tag parent no longer prints a warning for each tag that uses it.
  • nimbus-docs add api-layout ends by pointing to the API route instead of src/components.ts.
  • The Markdown version of an API page fences cURL samples as bash.

• #​220 cd7f0da Thanks @​MohamedH1998! - - Request field lists no longer show properties marked readOnly across schema alternatives, and response field lists no longer show those marked writeOnly across alternatives. Synthesized examples use the selected alternative; authored examples retain their values. Webhook payloads read like responses. Cite a readOnly field under the response.

  • A string example under a non-JSON media type such as application/x-ndjson is sent verbatim in generated samples.
  • Object form examples with media-type parameters such as ; charset=utf-8 generate per-field samples; authored encoded strings keep their bytes.

• #​234 1b546af Thanks @​MohamedH1998! - - astro dev and astro check no longer delete the build's page-collection list, so nimbus-docs check runs its page-collection checks after a build.

  • nimbus-docs lint and check say when the lint rules in your Astro config changed since .nimbus/lint.json was written, and to run astro sync.
  • check marks a scope that skipped some checks ◐ ok, partly checked, and says --types covers .ts and .tsx files only (run astro check for .astro).
  • nimbus-docs check --help lists check's own flags.
  • The adapter warning for @astrojs/cloudflare 14.2.x says only a cold astro dev can fail; builds aren't affected.
  • An invalid API spec, such as Swagger 2.0, fails the build with its message and no stack trace.
  • Request-rendered routes that export getStaticPaths() get one line explaining that the rendering policy renders them on request.
  • On a static Cloudflare site with trailingSlash: "always" and build.format: "file", the build and check warn that every /page/ link redirects, and name the wrangler.jsonc fix.
  • Repeated API spec warnings that differ only by source print once, with a count.
  • lint --rule nimbus/mdx-syntax says the syntax check always runs.

• #​211 ff1cd57 Thanks @​MohamedH1998! - Load @iconify-json icon sets from the site root, so a build started from another directory still finds them.

• #​237 7a07851 Thanks @​MohamedH1998! - - Search is indexed however astro build is started, including ./node_modules/.bin/astro build.

  • A site's pagefind.yml applies when the build starts from another folder with --root.
  • The build says to install Pagefind only when it isn't installed.

• #​230 25d21cf Thanks @​MohamedH1998! - - Server scaffolds for Node, Vercel, and Netlify render docs pages on request, so Markdown negotiation works on them.

  • Scaffold into . or an empty folder, including a freshly cloned repository.
  • New repositories get a first commit; scaffolding inside an existing repository no longer creates a nested one.
  • npm create installs a handful of packages instead of the whole framework.
  • A missing package manager fails before anything is written, and a mistyped flag suggests the right one.
  • Yarn sites ignore .yarn/ the way Yarn recommends, and pin Yarn inside a folder that pins another package manager.
  • The starter's AGENT.md explains sidebar groups, order, and links.
  • nimbus-docs check and --help show commands for your package manager.

• #​213 7350707 Thanks @​MohamedH1998! - When an API's spec can't be published because a $ref isn't a reference string, the build warning names where it is instead of printing [object Object].

• #​227 ea8712d Thanks @​sansynx! - Add UTF-8 Content-Type headers for prerendered llms indexes, full documents, page Markdown, and robots.txt. Keep rules scoped to Nimbus file paths and preserve explicit owner Content-Type policies.

v0.17.0

Compare Source

Minor Changes

• #​204 a8e0d02 Thanks @​MohamedH1998! - - Agent files follow the rendering policy: a page's index.md/index.mdx renders in its collection's mode, a section's llms.txt in the mode of the collection it lists, llms.txt/llms-full.txt in rendering.default, and homepage Markdown in the root collection's mode. Mounted collections get their own agent routes, copied starter routes keep working unchanged, and static sites don't change.

• #​201 855091c Thanks @​MohamedH1998! - Add samples.generate to choose which languages Nimbus generates code samples in, and fix generated samples and examples that sent different values from the page.

  • samples.generate: set samples: { generate: ["curl"] } on an api entry to generate only a cURL request, instead of cURL, TypeScript, and Python, on every operation. [] generates none, so operations show only their authored x-codeSamples. The default is unchanged: all three. samples.keepGenerated still picks the generated languages shown next to authored samples; each of its languages must now also be in generate.
  • Python and TypeScript bodies: in Python, a string containing a newline, carriage return, or tab no longer breaks the sample with a SyntaxError, and object keys with quotes or backslashes stay valid. In both languages, a backslash is no longer read as an escape (C:\\temp\\new was sent with a tab and a newline), including in text bodies such as text/plain. A JSON body of false, 0, or "" is now sent instead of dropped.
  • cURL bodies: a body containing ' was passed through an unquoted heredoc, so the shell collapsed backslashes and ran $NAME and backticks in the example when the sample was pasted. The heredoc is now quoted.
  • Form bodies: application/x-www-form-urlencoded bodies were dropped from every sample and are now sent in all three languages. A property with an encoding entry follows OpenAPI: style, explode, or allowReserved select query-style serialization, and an entry without them sends the value as its contentType, so an object is sent as JSON. A property without an entry nests objects in brackets (metadata[plan]=pro), repeats the name for each item of a scalar array (tags=a&tags=b), and indexes arrays of objects (items[0][price]=p_1). A string example is read as an encoded form; a form example with no fields sends no body. multipart/form-data bodies are still omitted.
  • Form encoding: explicit JSON content types serialize scalar values as JSON before form encoding. allowReserved: true preserves valid percent-encoded triples and safe reserved characters without double encoding; form delimiters and unsafe characters remain encoded.
  • cURL text bodies: a body starting with @ is sent as text instead of uploading the file it names.
  • Joined form values: a ,, |, or space inside an array item no longer reads as a separator with explode: false, unless allowReserved: true leaves a , unencoded.
  • Empty form field names: cURL now sends =value like the other languages.
  • Request example: an operation without code samples, such as with samples.generate: [], shows its request example on the page.
  • Swagger 2.0: a Swagger 2.0 document now fails the build with Swagger 2.0 isn't supported. Convert it to OpenAPI 3.x first. and the document's path, instead of building pages with no server URL, unknown parameter types, and missing response schemas. The API reference docs show how to convert one before each build.

  If the installed httpsnippet writes a body differently from the layout Nimbus corrects, that language's sample is left out rather than shown with an unescaped body. Authored x-codeSamples are unchanged. New sites scaffolded by create-nimbus-docs use this release.

• #​207 d77ff08 Thanks @​MohamedH1998! - - A request-rendered API family can set versionMode: "query": one URL per operation, the version in ?api-version= (absent means the default, unknown is 404, hidden versions reachable by query only). Generated same-version links carry the query; discovery covers the default version at version-free URLs; non-default pages are noindex with the default counterpart as canonical. Path mode stays the default and is unchanged.

  • API version ids may contain dots, and must start and end with a letter or digit. An id like -v1 or v1- now fails validation; rename it.

• #​198 86b573a Thanks @​MohamedH1998! - - Skills in skills/<name>/SKILL.md folders are published at /.well-known/agent-skills/ with a discovery index, archives for multi-file skills, and digests.

• #​199 b8a8dbd Thanks @​MohamedH1998! - - Sites with API collections publish every spec, including hidden versions, as one self-contained openapi.json at its mount path, and list each visible API in an RFC 9727 catalog at /.well-known/api-catalog. Set publishSpec: false to keep a spec private.

• #​195 b685092 Thanks @​MohamedH1998! - - Add discovery files, homepage Markdown, and Link headers to all sites.

  • Add editable Content Signals to the starter's robots.txt.

• #​205 7b76521 Thanks @​MohamedH1998! - - Sidebar groups are native details/summary with one class per row type, a CSS caret, and no animation; a group's landing page lists as an "Overview" child row. Each page renders one sidebar tree, shared by the desktop rail and the mobile drawer, and a large sidebar's page HTML drops by roughly 80%. The state scripts drive the old copied markup too.

• #​203 62d7956 Thanks @​MohamedH1998! - - Only collections made with Nimbus's helpers (docsCollection(), componentsCollection(), withNimbusMarkdown()) become pages; every other collection is plain Astro data with no naming rule, and the _ prefix convention is removed. If rendering is set, a site's own page collection with a catch-all route now needs an entry in rendering.collections.

• #​196 2e200ce Thanks @​MohamedH1998! - - The starter registers a search_documentation WebMCP tool, backed by the site's Pagefind index.

• #​200 c17a945 Thanks @​MohamedH1998! - - On server output, a request-rendered page returns its Markdown when the request prefers text/markdown; the URL stays canonical and both forms send Vary: Accept.

  • The starter homepage renders on request when a collection already does under server output, so it negotiates too. All-build homepages remain prerendered in production.
  • Preserve owner static-header rules while adding discovery fields, and support prose request rendering and published Markdown negotiation through Astro adapters and standard HTTP on non-Cloudflare deployments.
  • Recreate the isolated browser-agent Pagefind instance after observable search failures and give accurate connection/reload guidance. Pagefind's swallowed index-chunk failures remain a documented upstream limitation.
  • Include a release-matched agent-interface guide in the framework package and point generated project instructions to it.

Patch Changes

• #​201 7b8c3e8 Thanks @​MohamedH1998! - For methods that support request bodies, preserve JSON null in generated TypeScript and
  Python samples. They now send the same four-byte JSON payload as cURL instead of omitting it.
  Absent request bodies remain absent, and schema-derived examples and authored code samples
  keep their existing behavior.

• #​193 bcc1b1e Thanks @​sansynx! - Keep synced tabs usable when browser storage writes fail because the storage quota is full.

• #​206 bcfe446 Thanks @​MohamedH1998! - - The version picker keeps a reader on the same operation when its operationId changed between versions but its HTTP method and path shape did not (including a renamed path parameter). The pairing is order-independent and never guesses: anything ambiguous stays unmatched and goes to the version landing, as before.

v0.16.0

Compare Source

Minor Changes

• #​191 18b0005 Thanks @​MohamedH1998! - Generated API code samples show <name>, such as <account_id>, for a path parameter unless a value declared in its schema produces the generated value, instead of a guess such as string, 0, or a made-up UUID. This holds for any schema shape, including allOf, unions, and if/then. Required query parameters and headers keep the generated value, guesses included; one with no schema, or whose generated value is an array or object, now shows <name> instead of its bare name. A parameter's own example or examples now wins over its schema, as OpenAPI specifies. Credential placeholders now say what goes there: Bearer <token>, Basic <credentials>, and the API key's name, such as <X-API-Key>. Placeholders render unencoded in every language, including names that URL encoding would change, such as filter[name]. Declared values, including ones that look like a placeholder, and request bodies are unchanged.

  Every authored x-codeSamples entry is now kept, including several with the same lang; previously only the first entry per language was shown. Each sample has an id, unique within the operation: the language for the first sample in that language, then python-2, python-3. A repeated label, or a missing one that falls back to lang, is numbered for display (Python (2)) in the picker and the Markdown version. To give each of them its own picker option, update the api-code-rail registry component with nimbus-docs add api-code-rail, choosing Overwrite for its two files; see the upgrade entry api-code-sample-ids. Without the update, a language's samples show one after another.

  Add samples.keepGenerated to api entries, so an operation with authored x-codeSamples can still show generated samples. Kept samples follow the authored ones, and an authored sample in the same language replaces the generated one. The default, [], keeps today's behavior.

  api: [{ collection: "api", spec: "./src/api/openapi.yaml", samples: { keepGenerated: ["curl"] } }],

• #​190 9f54406 Thanks @​MohamedH1998! - Breaking: API references no longer publish a page for each components/schemas entry. To keep schema pages, add schemaPages: true to the api entry; that restores today's output exactly.

  With schema pages off (the new default), schemas still shape operation pages, including the properties previewed under each union variant, but get no page, Markdown version, OG image, sitemap, search, or llms.txt entry, or citation coordinate. Union variants, discriminator mappings, and map<Name> types render as text. A citation in your content to a schema or schema field fails the build and names the setting. Schema names still claim their schemas/<Name> routes, so turning pages on can't collide with an operation. On a 400-operation slice of a large public spec, this cut output files by 60% and build time by more than half.

  getApiPageProps now throws for a coordinate that has no page, such as a schema with schema pages off or an x-tagGroups category, instead of returning the API root's URLs as if they were its own.

• #​181 71ff242 Thanks @​MohamedH1998! - Add sidebar to api entries, so large API references stop putting the whole navigation tree in every page. "full" (the default) keeps today's behavior. "on-demand" includes top-level items plus the current page's branch. A collapsed group opens in place and loads its rows from its own page, where the sidebar lists them open; a group without a page, such as an x-tagGroups category, loads them from the API overview. Without JavaScript, a collapsed group's label still links to its page. The mode is read from the api entry in the Nimbus config, including for sites that pass their entry to apiCollection({ … }).

  api: [{ collection: "api", spec: "./src/api/openapi.yaml", sidebar: "on-demand" }],

  ApiNavItem gains optional deferred and childrenHref fields. @cloudflare/nimbus-docs/client adds initNavSidebar(), and @cloudflare/nimbus-docs/runtime adds navStateScript, an inline script, and navBuildId, which a sidebar renders as data-nb-nav-build. Together they keep a sidebar's open groups, loaded rows, and scroll position from page to page for the session, restored before the page paints and without replaying animations. Cached rows are tied to the build that rendered the page, so rows cached before a deployment are never shown after it, including on client-side navigation. apiCollection({ … }) warns when it sets a sidebar the config doesn't match.

  A tag's x-displayName now sets its label in the sidebar, page title, and breadcrumbs, while its name still decides its coordinate and route. This lets a spec group hundreds of flat tags under readable parents.

  Group pages now list their subsections (ApiSectionPage.sections), in HTML and Markdown, so every page stays reachable without the sidebar. The API overview no longer links an x-tagGroups category to itself: it lists the category's member sections instead. Both changes apply in every sidebar mode.

  Starter components: ApiSidebarItem renders a deferred group as a closed group with an empty panel, and ApiLayout mounts initNavSidebar and the restore script for both the desktop rail and the mobile drawer. The API sidebar now keeps the groups a reader opened and its scroll position from page to page in every mode, and no longer fades or replays group animations during navigation. The mobile drawer moved ahead of the desktop rail in ApiLayout, so one inline script restores both before the page paints. ApiBody lists a group page's subsections.

  Existing sites keep working unchanged with the default sidebar: "full". "on-demand" needs the new API components: with older ones, the build fails and names the outdated files. Update them with nimbus-docs add api-layout, choosing Overwrite for api-layout and api-sidebar. nimbus-docs add now warns when the registry serves components from a different release than the project's @cloudflare/nimbus-docs.

• #​194 a14c58f Thanks @​MohamedH1998! - nimbus/internal-link follows redirects:

  • Links through a working redirect pass. Nimbus reads the build's _redirects and Astro's redirects; the new redirectsFile integration option adds a redirects file your deployment reads under another name. A redirect to a page that doesn't exist is still a broken link.
  • Redirects match the way your platform matches them: Netlify's rules with a netlify.toml, Cloudflare's otherwise.
  • New nimbus/redirected-link rule (off by default) reports links that go through a permanent redirect, with the URL to use instead.
  • Run astro build again after upgrading: .nimbus/routes.json has a new version.

Patch Changes

• #​185 11e6d85 Thanks @​MohamedH1998! - Static API pages color their code samples again. _nimbus/shiki.css now defines every token class the pages use; it used to miss the classes only API samples used, so on a site with only API pages, every sample rendered without color.

• #​187 278a3ff Thanks @​MohamedH1998! - nimbus/internal-link can now gate CI:

  • .nimbus/routes.json lists every file the build produced, so links to /llms.txt, feeds, .md alternates, and public/ files no longer show as broken.
  • When the rule is on and .nimbus/routes.json is missing, isn't valid JSON, or was written by another version of Nimbus, nimbus-docs lint reports one error on that file and exits 1, instead of skipping the rule. When astro build starts, it deletes the previous build's file, or marks it incomplete if it can't be deleted, so lint never accepts it after a failed build. If the file can be neither deleted nor changed, the build fails until its permissions are fixed. Run astro build before nimbus-docs lint. nimbus-docs check is unchanged: a missing file is still a note there, not an error.
  • nimbus-docs lint exits 1 when .nimbus/lint.json is missing, instead of reporting a clean run with every rule off. Run astro build or astro dev first; they write the rules from your Astro config there. --rule <code> still runs that one rule without it.
  • A bare relative link such as [CLI](cli) now counts as a relative link, like ./cli, instead of being looked up as /cli.
  • Some lint runs that passed before now fail. Links that include Astro's base (for example /docs/guide under base: "/docs") used to pass, but Nimbus adds the base again when the page renders, so they lead to /docs/docs/guide, a 404. Lint now reports them and suggests the link without the base. To fix them, remove the base from the link. Write ignore patterns without the base too.

• #​183 e5fe9f3 Thanks @​MohamedH1998! - - Generated Markdown (.md pages and llms-full.txt) is built from the parsed MDX, so it keeps the structure the HTML page shows: code blocks and nested lists stay in their list items, components stay inside the list item, card, or blockquote that holds them, and nested components keep their own content.

  • Components without a Markdown renderer no longer leave raw tags.
  • Text MDX reads differently from Markdown, such as an indented line or an over-indented fence, is written so it reads the same.
  • import and export lines no longer appear in generated Markdown.

• #​186 aff3e9f Thanks @​MohamedH1998! - - A markdown.componentMap renderer's output goes into generated Markdown as written again (apart from surrounding whitespace), unless it uses another component, which still converts. In a table cell or a sentence, output with a line break or | is converted so the cell or sentence stays whole.

  • A page whose MDX can't be parsed for generated Markdown keeps its text there, with a warning, instead of failing the build.

• #​182 9d2051c Thanks @​MohamedH1998! - - outdated and diff also compare AGENT.md, CLAUDE.md, and tsconfig.json with the upstream starter, so upgraded sites get guidance fixes. Files every site rewrites, such as package.json, are never compared.

  • diff <file> --apply records the tag it took the file from in nimbus.json (templatesTagByFile), so the file no longer shows as a hand-merge after the next upstream change.
  • Each command rejects flags it doesn't read. Before, outdated --cwd site ignored --cwd and checked the current directory. Scripts that pass an ignored flag now exit 1.
  • check and add adapter-cloudflare use @astrojs/cloudflare@~14.3.0. pnpm saved the old >=14.3.0 <14.4.0 as ^14.3.x, which allows 14.4.
  • add and init print plain lines without a terminal, instead of spinner escapes.
  • A duplicate page or unknown MDX component fails the build without a stack trace.

v0.15.2

Compare Source

Patch Changes

• #​179 8ded65b Thanks @​MohamedH1998! - - migrate refuses to record a reviewed version when the project's @cloudflare/nimbus-docs isn't installed, and says to install dependencies. Before, npx @cloudflare/nimbus-docs migrate --yes in a fresh clone recorded the latest release while the lockfile installed an older one, and the build then failed with advice that failed too.
  • When nimbus.json records a version newer than the installed one, the build error says to install dependencies or upgrade, with the command, instead of suggesting migrate.
  • migrate --dry-run --diff with nothing pending prints the same result and next step as migrate --dry-run, instead of nothing.
  • Before the first install, check reports one "Dependencies aren't installed" error with the install command, instead of offering to install pagefind and wrangler one at a time or reporting a TypeScript error. The command follows the site's packageManager, lockfile, or pnpm-workspace.yaml / .yarnrc.yml, not the tool that ran the CLI, so a pnpm site checked with npx is told pnpm install.
  • After check --fix without a terminal, the footer names check --fix --yes for skipped installs, and says a value such as site needs editing by hand or an interactive terminal. Before, it only said to rerun check --fix "in a terminal", even for installs.
  • check --help gives the same stop rule as the starter's AGENT.md.
  • The nimbus/request-rendering-build-required note no longer claims a build resolves it. check doesn't verify request-rendered pages; a passing production build is the gate.
  • Under trailingSlash: "always" with build.format: "file", canonical and og:url URLs keep the trailing slash, so they match page links and the sitemap.
  • <PackageManagers type="exec"> runs the project's installed CLI with every package manager: pnpm nimbus-docs and yarn nimbus-docs for a scoped package, instead of pnpm @cloudflare/nimbus-docs.
  • The starter fixes search on sites whose base has no trailing slash, such as base: "/docs". Existing sites: run npx @cloudflare/nimbus-docs outdated, then diff src/components/ui/search/providers/pagefind.ts --apply.

v0.15.1

Compare Source

Patch Changes

• #​177 adb8efe Thanks @​MohamedH1998! - Add the copy-prompt registry component. Run nimbus-docs add copy-prompt to install CopyPrompt, a one-line prompt with a Copy prompt button for readers to paste into an AI coding agent. New sites don't include it by default.

• #​171 41376dd Thanks @​MohamedH1998! - Fix upgrade checks and CLI guidance.

  Behavior changes

  • nimbus-docs check warns about the placeholder site instead of exiting 1, matching the build. A CI job that relied on check failing for an unset site needs its own check.
  • migrate --dry-run and migrate --json report passed and exit 0 when no migrations or required reviews remain and a baseline is recorded, including when no entries fall between the recorded and installed versions.

  Upgrades

  • Sites upgrading from before 0.13.0 with a custom loader on a collection Nimbus indexes now see the 0.13.0 withNimbusMarkdown() requirement in migrate and outdated.
  • outdated --json adds summary.requiredPackageApis, the required subset of summary.packageApis, and a warnings array. It warns when the compared starter needs a newer package than the project has, which also blocks diff --apply.
  • outdated and migrate use the same terms: migrations and upgrade reviews. migrate prints each outcome once, and declining its record prompt says how to record the baseline later.

  CLI

  • Upgrade and migrate hints, and the build errors that point at migrate or init, print a runnable command instead of a raw Node path or a bare nimbus-docs. pnpm and Yarn projects that declare the package get the local bin, such as pnpm nimbus-docs migrate. With --cwd, the command runs from the current directory and pins the project's Nimbus version, such as npx @cloudflare/nimbus-docs@0.15.1 migrate --cwd 'site' --yes.
  • After check --fix without a terminal, the hint says what the remaining fixes need: a terminal for prompts, or --yes for installs.
  • check lists what it skipped when the api config or the rendering policy isn't a plain literal, or when src/content.config.ts is missing.
  • lint --help lists the lint rules and the --color and --no-color flags.
  • add suggests registering only the component you asked for in src/components.ts, not its dependencies.

  Cloudflare

  • add adapter-cloudflare installs @astrojs/cloudflare 14.3, which fixes a crash on the first astro dev with a cold cache ("Dev server process exited before becoming ready"). Existing sites can upgrade with pnpm add @astrojs/cloudflare@~14.3.0.
  • add adapter-cloudflare names the policy it adds: rendering: { default: "request" }, which renders every collection on request. To render only API pages on request, set that policy before running the installer, which keeps an existing policy.

• #​178 fd53431 Thanks @​MohamedH1998! - Behavior changes

  • The duplicate-route check uses a page's frontmatter slug, so a.mdx with slug: b next to b.mdx now fails the build, as other duplicate routes do. Before, the collision went unreported and Astro served one of the two pages.
  • withBase("/", base) returns the base without a trailing slash, such as /docs, when page URLs have none: under trailingSlash: "never", or build.format: "file" with "ignore". Code that appends to the result or compares it with /docs/ needs updating.

  check and init

  • check warns when an installed Astro adapter is outside the range Nimbus supports, such as @astrojs/cloudflare 14.1, with the command that installs a supported version. It doesn't change the version itself.
  • On a PR preview, check says which release to pass to migrate --from once you install a release, instead of repeating "run a build, then check again".
  • init --force rebuilds only the component and install records. It keeps the rest of a valid nimbus.json: the reviewed baseline, the starter version and variant, a preview's record, and the server-output opt-in. Before, it reset them, which brought back the "no reviewed upgrade baseline" build failure.

  build.format: "file" and base

  • With build.format: "file", canonical URLs and og:url no longer end in .html, pages get previous and next links, the sidebar marks the current page, and breadcrumbs show page titles instead of "Welcome.Html".
  • With a base and no trailing slashes, the home link, "Home" breadcrumb, and 404 page link to /docs, matching the home page's canonical URL, instead of /docs/.

  Routes and Markdown

  • In per-page .md files and llms-full.txt, a code block in a nested list item stays in the item, so the text after it no longer turns into code, and a code block in a numbered item no longer splits the list.
  • The version switcher and missing-page redirects find pages in folders with dots, such as 1.2.3/, without a slug, and section index pages such as guides/index.mdx. A previousSlug written as a file path, such as guides/index, names the section's page.

• #​172 6637381 Thanks @​MohamedH1998! - Make generated links, the sitemap, and Markdown output follow the site config.

  Behavior changes

  • Under the default trailingSlash: "ignore", api.ref citation links now end in /, like sidebar links and the canonical URL, in pages, per-page .md files, and llms-full.txt.
  • With trailingSlash: "ignore" and build.format: "file" or "preserve", generated links no longer end in /, so they reach the pages Astro builds.

  Links, sitemap, and routes

  • Sidebar, navigation, breadcrumb, pagination, and citation links, and the API reference's sidebar, breadcrumbs, and type links, follow Astro's trailingSlash and build.format. Under "never" they drop the slash, and API links no longer 404 under "always" or "never". With the default build.format, they match the canonical URL.
  • noindex: true pages are left out of the sitemap on sites without base, as they already were with base.
  • The docs schema accepts Astro's slug frontmatter field, so a page in a 1.2.3/ folder can keep its dots: slug: 1.2.3/setup serves it at /1.2.3/setup/. The version switcher and missing-page redirects use the slug too.
  • API pages no longer return 500 ("missing prepared page data") in astro dev after the Astro config switches to server output while the dev server is running, for example after add adapter-cloudflare.

  Generated Markdown

  • Per-page .md files and llms-full.txt keep the indentation of code blocks in MDX pages, so YAML and Python keep their meaning. Code inside <Aside> gets the > prefix on every line.
  • A citation inside a longer fence, such as a ```` fence that shows a example, stays literal, as does one in a fence opened on a list-item line (`-yaml`). That fence also stays inside its list item in the Markdown output.
  • <PackageManagers> Markdown includes the package for every type and matches the HTML commands. type="dlx" pkg="@cloudflare/nimbus-docs" args="list" now renders npx @cloudflare/nimbus-docs list instead of npx list.

• #​170 ae346f0 Thanks @​MohamedH1998! - Prerelease versions, such as the PR previews published to pkg.pr.new, select the upgrade entries of the release they preview. Two prereleases of the same release no longer count as newer than each other, so recording one and installing another doesn't fail the build.

v0.15.0

Compare Source

Minor Changes

• #​162 982a47d Thanks @​MohamedH1998! - Register API collections from the Nimbus config. apiCollection() now takes no arguments and reads the api entry whose collection matches its key in src/content.config.ts, so each spec is declared once, in the inline Nimbus config in astro.config.ts:

  // astro.config.ts
  const nimbusConfig = defineNimbusConfig({
    site: "https://example.com",
    title: "Example",
    api: [{ collection: "api", spec: "./src/api/openapi.yaml" }],
  });
  
  // src/content.config.ts
  export const collections = {
    docs: defineCollection(docsCollection()),
    api: defineCollection(apiCollection()),
  };

  The api-reference recipe now uses this shape and no longer creates nimbus.config.ts, so nimbus-docs check validates the whole config statically and add adapter-cloudflare edits rendering in place.

  A collection key with no api entry fails content sync, and an api entry without an apiCollection() under its key fails the build, including a key registered with another loader. Both messages name the Nimbus config and src/content.config.ts, and nimbus-docs check reports the same mismatches without building.

  apiCollection(options) and @cloudflare/nimbus-docs/config are unchanged, and sites built by earlier versions of the recipe keep building with no changes. Upgrade note: in astro dev, that shape silently ignores edits to the api entry in nimbus.config.ts until a manual restart. To pick up edits automatically, move the Nimbus config back into astro.config.ts, delete the lookup in src/content.config.ts, and register the collection with apiCollection(). `nimbus

[!IMPORTANT]
✂ PR body was truncated to here.

---

Configuration

📅 Schedule: (in timezone Europe/Istanbul)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Enabled.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.