Skip to content

chore: replace astro-icon with nimbus-docs Icon, bump nimbus-docs to 0.10.0 #32647

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mvvmm merged 9 commits into from
Aug 11, 2026
+324 −783
Merged

chore: replace astro-icon with nimbus-docs Icon, bump nimbus-docs to 0.10.0 #32647

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
84574ab
chore: point nimbus-docs at PR #76 preview build
mvvmm Aug 10, 2026
7850a5d
chore: remove astro-icon, use nimbus-docs Icon component
mvvmm Aug 10, 2026
c40f379
chore: update stale symbol/use comment in package-managers client
mvvmm Aug 11, 2026
37a5833
Merge remote-tracking branch 'origin/production' into chore/nimbus-ic…
mvvmm Aug 11, 2026
8c8acd8
fix: replace astro-icon import in TunnelHostnameRoutingDiagram, merge…
mvvmm Aug 11, 2026
f10afdc
chore: update @cloudflare/nimbus-docs to 0.10.0
mvvmm Aug 11, 2026
50b5c4d
chore: bump astro to ^7.2.0 to satisfy nimbus-docs 0.10.0 peer range
mvvmm Aug 11, 2026
7c17c6c
fix: correct RSSButton comment — astro-icon not Starlight Icon was sw…
mvvmm Aug 11, 2026
9e04bcc
fix: only map Starlight rss sentinel to ph:rss-simple, pass other ico…
mvvmm Aug 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 4 additions & 6 deletions astro.config.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,6 @@ import { fileURLToPath } from "node:url";
import { defineConfig } from "astro/config";
import react from "@astrojs/react";
import tailwindcss from "@tailwindcss/vite";
import icon from "astro-icon";
import skills from "astro-skills";
import nimbus, {
defineConfig as defineNimbusConfig,
Expand Down Expand Up @@ -106,8 +105,8 @@ const iconAlias = {
if (!pathOnly?.endsWith(".mdx") && !pathOnly?.endsWith(".md")) return null;
if (!/icon\s*=/.test(code)) return null;

// Starlight ships a native `seti:` file-icon set; Nimbus routes icons
// through astro-icon, which has no `seti` set. Map every `seti:` name the
// Starlight ships a native `seti:` file-icon set; Nimbus's icon system
// has no `seti` set. Map every `seti:` name the
// shared content uses onto an installed set (vscode-icons / ph /
// simple-icons). The substitute glyphs differ visually from Starlight's
// seti set — a parity item tracked for the parity gate (Epic F), not a
Expand Down Expand Up @@ -141,8 +140,8 @@ const iconAlias = {
plan: "ph:file-text",
};
// Bare icon names (no set prefix) resolve against Starlight's built-in
// icon set in the default build; under Nimbus they go through astro-icon
// (local `src/icons` + installed iconify sets). Names not present locally
// icon set in the default build; under Nimbus they go through the Icon
// component (local `src/icons` + installed iconify sets). Names not present locally
// are mapped here onto an installed set. Glyphs differ visually from
// Starlight's — a parity item for the parity gate (Epic F).
const BARE: Record<string, string> = {
Expand Down Expand Up @@ -204,7 +203,6 @@ const markdown = {
};

const integrations = [
icon(),
react(),
// Injects /.well-known/agent-skills/* routes (index.json, SKILL.md, tarballs).
skills(),
Expand Down
5 changes: 2 additions & 3 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@
"@astrojs/sitemap": "3.7.3",
"@base-ui/react": "1.6.0",
"@cloudflare/ai-search-snippet": "0.0.43",
"@cloudflare/nimbus-docs": "0.8.2",
"@cloudflare/nimbus-docs": "0.10.0",
"@cloudflare/vitest-pool-workers": "0.18.8",
"@cloudflare/workers-types": "5.20260727.1",
"@eslint/js": "9.39.4",
Expand Down Expand Up @@ -83,8 +83,7 @@
"@types/react-dom": "19.0.4",
"@types/unist": "3.0.3",
"@typescript-eslint/parser": "8.65.0",
"astro": "^7.1.4",
"astro-icon": "1.1.5",
"astro": "^7.2.0",
"astro-skills": "0.1.1",
"cidr-tools": "12.1.2",
"clsx": "2.1.1",
Expand Down
866 changes: 207 additions & 659 deletions pnpm-lock.yaml
View file
Open in desktop

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion src/components.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ export { Badge } from "./components/ui/badge";
export { Code } from "./components/ui/code";
export { FileTree } from "./components/ui/file-tree";
export { default as LinkButton } from "./components/ui/link-button/LinkButton.astro";
export { Icon, Icon as AstroIcon } from "astro-icon/components";
export { default as Icon } from "@cloudflare/nimbus-docs/components/Icon.astro";

export { default as Render } from "./components/Render.astro";
export { default as APIRequest } from "./components/cf/APIRequest.astro";
Expand Down
24 changes: 12 additions & 12 deletions src/components/AiSearchIndexingDiagram.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
import { Icon as AstroIcon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";

interface Props {
autoPlay?: boolean;
Expand Down Expand Up @@ -91,7 +91,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true"
><AstroIcon name="r2" /></span
><Icon name="r2" /></span
>
<span class="asid-node-title">R2 bucket</span>
</span>
Expand All @@ -107,7 +107,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true"
><AstroIcon name="browser-run" /></span
><Icon name="browser-run" /></span
>
<span class="asid-node-title">Website</span>
</span>
Expand Down Expand Up @@ -153,7 +153,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
<span class="asid-node-head">AI Search · R2</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asid-node-title">Built-in storage</span>
</span>
Expand All @@ -174,7 +174,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
<span class="asid-node-head">Workers AI · toMarkdown()</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true"
><AstroIcon name="workers-ai" /></span
><Icon name="workers-ai" /></span
>
<span class="asid-node-title">Parsing</span>
</span>
Expand All @@ -191,7 +191,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
<span class="asid-node-head">AI Search</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asid-node-title">Chunking</span>
</span>
Expand Down Expand Up @@ -257,7 +257,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true">
<AstroIcon name="ai-gateway" />
<Icon name="ai-gateway" />
</span>
<span class="asid-node-title">Embedding</span>
</span>
Expand All @@ -274,7 +274,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true">
<AstroIcon name="ai-search" />
<Icon name="ai-search" />
</span>
<span class="asid-node-title">Vector index</span>
</span>
Expand All @@ -293,7 +293,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true">
<AstroIcon name="ai-search" />
<Icon name="ai-search" />
</span>
<span class="asid-node-title">Keyword tokenizer</span>
</span>
Expand All @@ -310,7 +310,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true">
<AstroIcon name="ai-search" />
<Icon name="ai-search" />
</span>
<span class="asid-node-title">Inverted index</span>
</span>
Expand All @@ -330,7 +330,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
<span class="asid-node-head">AI Gateway / Workers AI</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true">
<AstroIcon name="ai-gateway" />
<Icon name="ai-gateway" />
</span>
<span class="asid-node-title">Embedding</span>
</span>
Expand All @@ -344,7 +344,7 @@ const { autoPlay = true, loop = true, keyword = true } = Astro.props;
<span class="asid-node-head">AI Search · Vectorize</span>
<span class="asid-node-body">
<span class="asid-icon" aria-hidden="true">
<AstroIcon name="ai-search" />
<Icon name="ai-search" />
</span>
<span class="asid-node-title">Vector index</span>
</span>
Expand Down
10 changes: 5 additions & 5 deletions src/components/AiSearchNamespacesDiagram.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
import { Icon as AstroIcon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";

interface Props {
autoPlay?: boolean;
Expand Down Expand Up @@ -132,7 +132,7 @@ const { autoPlay = true, loop = true } = Astro.props;
<span class="asnd-node-head">env.AI_SEARCH.get(id)</span>
<span class="asnd-node-body">
<span class="asnd-icon" aria-hidden="true"
><AstroIcon name="workers" /></span
><Icon name="workers" /></span
>
<span class="asnd-node-title">Worker</span>
</span>
Expand Down Expand Up @@ -202,7 +202,7 @@ const { autoPlay = true, loop = true } = Astro.props;
<span class="asnd-node-head">AI Search instance</span>
<span class="asnd-node-body">
<span class="asnd-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asnd-node-title">tenant-a</span>
</span>
Expand All @@ -215,7 +215,7 @@ const { autoPlay = true, loop = true } = Astro.props;
<span class="asnd-node-head">AI Search instance</span>
<span class="asnd-node-body">
<span class="asnd-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asnd-node-title">tenant-b</span>
</span>
Expand All @@ -228,7 +228,7 @@ const { autoPlay = true, loop = true } = Astro.props;
<span class="asnd-node-head">AI Search instance</span>
<span class="asnd-node-body">
<span class="asnd-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asnd-node-title">tenant-c</span>
</span>
Expand Down
8 changes: 4 additions & 4 deletions src/components/AiSearchOverviewDiagram.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
import { Icon as AstroIcon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";

interface Props {
autoPlay?: boolean;
Expand Down Expand Up @@ -52,19 +52,19 @@ const { autoPlay = true, loop = true } = Astro.props;
href="/ai-search/configuration/data-source/built-in-storage/"
>
<span class="asod-node-icon" aria-hidden="true">
<AstroIcon name="r2" />
<Icon name="r2" />
</span>
<span class="asod-node-title">Storage</span>
</a>
<a class="asod-node" href="/ai-search/configuration/models/">
<span class="asod-node-icon" aria-hidden="true">
<AstroIcon name="workers-ai" />
<Icon name="workers-ai" />
</span>
<span class="asod-node-title">AI models</span>
</a>
<a class="asod-node" href="/ai-search/configuration/indexing/">
<span class="asod-node-icon" aria-hidden="true">
<AstroIcon name="vectorize" />
<Icon name="vectorize" />
</span>
<span class="asod-node-title">Index</span>
</a>
Expand Down
20 changes: 10 additions & 10 deletions src/components/AiSearchQueryingDiagram.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
import { Icon as AstroIcon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";

interface Props {
autoPlay?: boolean;
Expand Down Expand Up @@ -48,7 +48,7 @@ const { autoPlay = true, loop = true } = Astro.props;
</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-gateway" /></span
><Icon name="ai-gateway" /></span
>
<span class="asqd-node-title">Query rewriting</span>
</span>
Expand Down Expand Up @@ -107,7 +107,7 @@ const { autoPlay = true, loop = true } = Astro.props;
</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-gateway" /></span
><Icon name="ai-gateway" /></span
>
<span class="asqd-node-title">Query embedding</span>
</span>
Expand All @@ -124,7 +124,7 @@ const { autoPlay = true, loop = true } = Astro.props;
</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asqd-node-title">Vector retrieval</span>
</span>
Expand All @@ -144,7 +144,7 @@ const { autoPlay = true, loop = true } = Astro.props;
</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asqd-node-title">Query tokenization</span>
</span>
Expand All @@ -161,7 +161,7 @@ const { autoPlay = true, loop = true } = Astro.props;
</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asqd-node-title">Keyword retrieval</span>
</span>
Expand Down Expand Up @@ -211,7 +211,7 @@ const { autoPlay = true, loop = true } = Astro.props;
</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asqd-node-title">Fusion</span>
</span>
Expand All @@ -235,7 +235,7 @@ const { autoPlay = true, loop = true } = Astro.props;
</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-gateway" /></span
><Icon name="ai-gateway" /></span
>
<span class="asqd-node-title">Reranking</span>
</span>
Expand All @@ -252,7 +252,7 @@ const { autoPlay = true, loop = true } = Astro.props;
<span class="asqd-node-head">AI Search · R2</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-search" /></span
><Icon name="ai-search" /></span
>
<span class="asqd-node-title">Chunk content retrieval</span>
</span>
Expand Down Expand Up @@ -299,7 +299,7 @@ const { autoPlay = true, loop = true } = Astro.props;
</span>
<span class="asqd-node-body">
<span class="asqd-icon" aria-hidden="true"
><AstroIcon name="ai-gateway" /></span
><Icon name="ai-gateway" /></span
>
<span class="asqd-node-title">Response generation</span>
</span>
Expand Down
4 changes: 2 additions & 2 deletions src/components/AiSearchVoiceDiagram.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
import { Icon as AstroIcon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";

interface Props {
autoPlay?: boolean;
Expand Down Expand Up @@ -95,7 +95,7 @@ const { autoPlay = true, loop = true } = Astro.props;
<span class="asvd-tools-label">tool</span>
<a class="asvd-tool" href="/ai-search/">
<span class="asvd-tool-icon" aria-hidden="true">
<AstroIcon name="ai-search" />
<Icon name="ai-search" />
</span>
<span class="asvd-tool-title">AI Search</span>
<span class="asvd-tool-sub">retrieval</span>
Expand Down
6 changes: 3 additions & 3 deletions src/components/ArtifactsCIWorkflowDiagram.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
import { Icon as AstroIcon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";

interface Props {
autoPlay?: boolean;
Expand All @@ -22,7 +22,7 @@ const { autoPlay = true, loop = true } = Astro.props;
<span class="stage-label">Artifacts repo changes</span>
<div class="node-card source-card">
<span class="node-icon" aria-hidden="true">
<AstroIcon name="artifacts" />
<Icon name="artifacts" />
</span>
<span class="node-name">Repository changes</span>
</div>
Expand Down Expand Up @@ -100,7 +100,7 @@ const { autoPlay = true, loop = true } = Astro.props;
<div class="deployment-stage">
<div class="deployment-card" data-step="7" aria-label="Deploy Worker">
<span class="deployment-icon" aria-hidden="true">
<AstroIcon name="workers" />
<Icon name="workers" />
</span>
<span class="deployment-name">Deploy Worker</span>
</div>
Expand Down
2 changes: 1 addition & 1 deletion src/components/Header.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
import { Icon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";
import { Button } from "./ui/button";
import { LinkButton } from "./ui/link-button";
import { ThemeToggle } from "./ui/theme-toggle";
Expand Down
2 changes: 1 addition & 1 deletion src/components/ProductCard.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
import { Icon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";

type Category = "compute" | "ai" | "storage" | "media" | "zero-trust";

Expand Down
2 changes: 1 addition & 1 deletion src/components/agent-setup/Accordion.astro
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
// Shared collapsible accordion row for the agent-setup pages. A native
// <details>/<summary> with a caret marker. FAQItem, TroubleshootingItem, and
// PlatformAccessDetails all delegate to this so the three stay aligned.
import { Icon } from "astro-icon/components";
import Icon from "@cloudflare/nimbus-docs/components/Icon.astro";

interface Props {
title: string;
Expand Down
Loading