@icebreakers/monorepo-templates 2.0.6 → 2.1.0

package/README.md

@@ -18,7 +18,7 @@ import {
 } from '@icebreakers/monorepo-templates'
 
 const libraries = getTemplateChoices({ category: 'library' })
-const vitepress = getTemplateDefinition('vitepress')
+const nimbus = getTemplateDefinition('nimbus')
 ```
 
 The source workspaces under the repository's `templates/` directory are private. This package is their supported distribution boundary.

package/README.zh-CN.md

@@ -10,7 +10,7 @@ repoctl 的内置项目模板和受管工作区资产包。
 import { getTemplateChoices, getTemplateDefinition } from '@icebreakers/monorepo-templates'
 
 const libraries = getTemplateChoices({ category: 'library' })
-const vitepress = getTemplateDefinition('vitepress')
+const nimbus = getTemplateDefinition('nimbus')
 ```
 
 仓库 `templates/` 下的源码工作区均为私有，本包是这些模板的正式分发边界。

package/assets/.agents/skills/repoctl/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: repoctl
-description: Create and maintain pnpm/Turborepo workspaces with repoctl. Use when the user says 使用 repoctl 创建项目, create a monorepo, pnpm create repoctl@latest, scaffold Vue/Hono/tsdown/vitepress, or run repo init/doctor/new/check.
+description: Create and maintain pnpm/Turborepo workspaces with repoctl. Use when the user says 使用 repoctl 创建项目, create a monorepo, pnpm create repoctl@latest, scaffold Vue/Hono/tsdown/Nimbus/VitePress, or run repo init/doctor/new/check.
 ---
 
 # repoctl
@@ -32,7 +32,7 @@ pnpm exec repo doctor
 | API / Hono service       | `hono-server`      |
 | TypeScript library / SDK | `tsdown`           |
 | Vue component library    | `vue-lib`          |
-| Documentation site       | `vitepress`        |
+| Documentation site       | `nimbus`           |
 | CLI                      | `cli`              |
 | Unspecified              | omit `--templates` |
 

package/assets/.agents/skills/repoctl/references/templates.md

@@ -8,7 +8,7 @@ Intent defaults:
 - library -> `tsdown` -> `packages/<name>`
 - web-app -> `vue-hono` -> `apps/<name>`
 - api-service -> `hono-server` -> `apps/<name>`
-- docs-site -> `vitepress` -> `apps/<name>`
+- docs-site -> `nimbus` -> `apps/<name>`
 - cli-tool -> `cli` -> `apps/<name>`
 
 Run `repo templates` to discover template keys, categories, default targets, and
@@ -36,7 +36,8 @@ Built-in template map:
 - vue-lib -> templates/vue-lib => packages/vue-lib
 - hono-server -> templates/server => apps/server
 - vue-hono -> templates/client => apps/client
-- vitepress -> templates/vitepress => apps/website
+- nimbus -> templates/nimbus => apps/docs (default documentation template)
+- vitepress -> templates/vitepress => apps/website (explicit alternative)
 - cli -> templates/cli => apps/cli
 
 Notes:

package/assets/.github/workflows/ci.yml

@@ -78,10 +78,6 @@ jobs:
       - name: Test
         run: pnpm test
 
-      - name: Check packaged monorepo creation
-        if: ${{ matrix.os == 'ubuntu-latest' && matrix.node-version == 22 }}
-        run: pnpm test:packaged-create
-
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
         env:

package/assets/.github/workflows/release.yml

@@ -35,6 +35,10 @@ on:
         required: false
         default: false
         type: boolean
+      source-sha:
+        description: Original main commit to recover (publish modes only)
+        required: false
+        type: string
 
 env:
   HUSKY: 0
@@ -104,6 +108,7 @@ jobs:
           REPO_RELEASE_PACKAGE: ${{ inputs.package }}
           REPO_RELEASE_VERSION: ${{ inputs.version }}
           REPO_RELEASE_DRY_RUN: ${{ inputs.dry-run }}
+          REPO_RELEASE_RECOVERY_SOURCE_SHA: ${{ inputs.source-sha }}
         run: pnpm exec repo release ci
 
       - name: Preserve npm publish progress

package/assets/package.json

@@ -73,25 +73,21 @@
   "devDependencies": {
     "@commitlint/cli": "^21.2.3",
     "@eslint/config-inspector": "^3.5.0",
-    "@icebreakers/commitlint-config": "workspace:*",
-    "@icebreakers/eslint-config": "workspace:*",
-    "@icebreakers/monorepo": "workspace:*",
-    "@icebreakers/stylelint-config": "workspace:*",
     "@types/node": "^26.6.3",
-    "@vitest/coverage-v8": "~5.0.2",
+    "@vitest/coverage-v8": "~5.0.3",
     "eslint": "^10.11.0",
     "execa": "^10.0.1",
     "husky": "^9.1.7",
     "lint-staged": "^17.6.0",
     "only-allow": "^1.2.2",
-    "repoctl": "workspace:*",
+    "repoctl": "latest",
     "stylelint": "^17.15.0",
     "tailwindcss": "^4.3.3",
     "tsd": "^0.33.0",
     "tsdown": "0.23.0",
     "turbo": "^2.11.5",
     "typescript": "^6.0.3",
-    "vitest": "~5.0.2",
+    "vitest": "~5.0.3",
     "yaml": "^2.9.1"
   },
   "publishConfig": {

package/assets/pnpm-workspace.yaml

@@ -24,6 +24,8 @@ overrides:
   js-yaml: 5.4.2
   nanoid: 6.0.1
   brace-expansion: 5.0.12
+  minimatch@<4>brace-expansion: 1.1.21
+  minimatch@>=4 <10>brace-expansion: 2.1.7
   cross-spawn: 7.0.6
   adm-zip: 0.6.1
   uuid: 14.0.2

package/assets/turbo.json

@@ -17,7 +17,9 @@
         ".env*",
         "package.json",
         "tsconfig*.json",
-        "*.config.{js,ts,mjs,mts}"
+        "*.config.{js,ts,mjs,mts}",
+        "public/**",
+        "nimbus.json"
       ],
       "outputs": [
         "dist/**",
@@ -30,12 +32,14 @@
         "^lint"
       ],
       "inputs": [
-        "**/*.{js,jsx,cjs,mjs,ts,tsx,cts,mts,vue}",
+        "**/*.{js,jsx,cjs,mjs,ts,tsx,cts,mts,vue,astro,css,scss,less}",
         "**/*.{json,html,md,mdx,yml,yaml}",
         "*.config.{js,ts,mjs,mts}",
         ".eslintrc*",
         ".stylelintrc*",
-        "package.json"
+        "package.json",
+        "public/**",
+        "nimbus.json"
       ],
       "outputs": []
     },
@@ -88,7 +92,10 @@
         ".env*",
         "test/**",
         "package.json",
-        "tsconfig*.json"
+        "tsconfig*.json",
+        "public/**",
+        "nimbus.json",
+        "*.config.{js,ts,mjs,mts}"
       ],
       "outputs": []
     },

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { t as prepareAssets } from "./prepare-BapI8ioj.mjs";
+import { t as prepareAssets } from "./prepare-2VvFwYDz.mjs";
 import process from "node:process";
 //#region src/cli.ts
 async function main() {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as isGitignoreFile, c as toWorkspaceGitignorePath, d as packageDir, f as skeletonDir, h as getAssetTargets$1, i as shouldSkipTemplatePath, l as templateChoices$1, m as assetTargets$1, n as sanitizePublishedWorkspaceContent, o as toPublishGitignorePath, p as templatesDir, r as createTemplateCopyFilter, s as toWorkspaceAssetPath, t as prepareAssets, u as assetsDir } from "./prepare-BapI8ioj.mjs";
+import { a as isGitignoreFile, c as toWorkspaceGitignorePath, d as packageDir, f as skeletonDir, h as getAssetTargets$1, i as shouldSkipTemplatePath, l as templateChoices$1, m as assetTargets$1, n as sanitizePublishedWorkspaceContent, o as toPublishGitignorePath, p as templatesDir, r as createTemplateCopyFilter, s as toWorkspaceAssetPath, t as prepareAssets, u as assetsDir } from "./prepare-2VvFwYDz.mjs";
 import path from "node:path";
 import fs, { access, open, readFile, rm } from "node:fs/promises";
 import exec from "nanoexec";
@@ -42,7 +42,7 @@ async function isPrepared() {
 	const checks = [
 		path.join(assetsDir, "AGENTS.md"),
 		path.join(assetsDir, "LICENSE"),
-		path.join(templatesDir, "tsdown")
+		...templateChoices$1.map((template) => path.join(templatesDir, template.source))
 	];
 	if (!(await Promise.all(checks.map(pathExists))).every(Boolean)) return false;
 	const sourceRoot = path.resolve(packageDir, "..", "..");

package/dist/{prepare-BapI8ioj.mjs → prepare-2VvFwYDz.mjs}

@@ -96,6 +96,14 @@ const templateChoices = [
 		target: "apps/cli",
 		category: "tool",
 		description: "TypeScript 命令行工具模板"
+	},
+	{
+		key: "nimbus",
+		label: "Nimbus 文档（默认）",
+		source: "nimbus",
+		target: "apps/docs",
+		category: "docs",
+		description: "默认文档模板：Nimbus + Astro，中英双语与 AI 文档入口"
 	}
 ];
 //#endregion
@@ -144,7 +152,9 @@ const skipDirs = /* @__PURE__ */ new Set([
 	".vite",
 	".tmp",
 	".vue-global-types",
-	".wrangler"
+	".wrangler",
+	".astro",
+	".nimbus"
 ]);
 const skipFiles = /* @__PURE__ */ new Set([
 	".DS_Store",
@@ -171,8 +181,18 @@ function createTemplateCopyFilter(rootDir) {
 //#region src/prepare/published.ts
 function sanitizePublishedManifestContent(content) {
 	const manifest = JSON.parse(content);
+	if (manifest.devDependencies) {
+		for (const name of [
+			"@icebreakers/commitlint-config",
+			"@icebreakers/eslint-config",
+			"@icebreakers/monorepo",
+			"@icebreakers/stylelint-config",
+			"playwright"
+		]) delete manifest.devDependencies[name];
+		if (manifest.devDependencies["repoctl"]?.startsWith("workspace:")) manifest.devDependencies["repoctl"] = "latest";
+	}
 	if (manifest.scripts) {
-		for (const name of Object.keys(manifest.scripts)) if (name.startsWith("dev:") || name === "test:dev-scenarios" || name === "test:worker-types" || name === "test:packaged-create") delete manifest.scripts[name];
+		for (const name of Object.keys(manifest.scripts)) if (name.startsWith("dev:") || name === "test:dev-scenarios" || name === "test:worker-types" || name === "test:packaged-create" || name === "test:packaged-nimbus") delete manifest.scripts[name];
 		manifest.scripts["dev"] = "turbo run dev --concurrency=20";
 		if (manifest.scripts["test"]) manifest.scripts["test"] = manifest.scripts["test"].replace(" && pnpm test:dev-scenarios", "");
 	}
@@ -360,7 +380,7 @@ async function removeSourceRepoChecks() {
 	const workflowPath = path$1.join(assetsDir, ".github/workflows/ci.yml");
 	if (await pathExists(workflowPath)) {
 		const workflow = await fs.readFile(workflowPath, "utf8");
-		await fs.writeFile(workflowPath, workflow.replace(/\r?\n\s+- name: Check Worker type generation from packaged templates\r?\n\s+run: pnpm test:worker-types\r?\n/g, "\n"));
+		await fs.writeFile(workflowPath, workflow.replace(/\r?\n\s+- name: (?:Check Worker type generation from packaged templates|Install browser for packaged documentation checks|Check packaged monorepo creation|Check packaged Nimbus documentation)\r?\n(?:\s+if: [^\r\n]+\r?\n)?\s+run: [^\r\n]+\r?\n/g, "\n").replace(/\n{3,}/g, "\n\n"));
 	}
 	const manifestPath = path$1.join(assetsDir, "package.json");
 	if (await pathExists(manifestPath)) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "2.0.6",
+  "version": "2.1.0",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",

package/template-data.mjs

@@ -47,4 +47,12 @@ export const templateChoices = [
     category: 'tool',
     description: 'TypeScript 命令行工具模板',
   },
+  {
+    key: 'nimbus',
+    label: 'Nimbus 文档（默认）',
+    source: 'nimbus',
+    target: 'apps/docs',
+    category: 'docs',
+    description: '默认文档模板：Nimbus + Astro，中英双语与 AI 文档入口',
+  },
 ]

package/templates/client/package.json

@@ -60,7 +60,7 @@
     "@vitejs/plugin-vue-jsx": "^5.1.6",
     "@vue/tsconfig": "^0.9.1",
     "consola": "^3.4.2",
-    "hono": "^4.13.11",
+    "hono": "^4.13.12",
     "tailwindcss": "^4.3.3",
     "typescript": "~6.0.3",
     "vite": "^8.3.1",

package/templates/nimbus/AGENTS.md

@@ -0,0 +1,12 @@
+# Documentation workspace
+
+This is a static Nimbus + Astro documentation site. Run commands in this workspace; install dependencies from the monorepo root after `corepack enable`.
+
+- Content lives in `src/content/docs/`; English uses the root and Chinese uses `zh/` with matching relative filenames. Keep both translations and links in sync. The directory tree supplies routes and navigation.
+- Layouts and components are project-owned. Keep modules small. Put styles in `src/styles/` so Stylelint checks every authored style.
+- Register MDX components in `src/components.ts`. Add a text conversion in `astro.config.ts` when a custom component conveys information that would otherwise disappear from Markdown.
+- Set the canonical `site` URL and project title in `astro.config.ts` before deployment. Static output is `dist/` and can be hosted anywhere.
+- Run `pnpm build`, `pnpm lint`, and `pnpm typecheck`. `typecheck` combines Astro diagnostics with TypeScript checks. Search uses the production Pagefind index; verify it with `pnpm preview` after building.
+- Verify `/llms.txt`, `/zh/llms.txt`, `/llms-full.txt`, and each page's `/index.md` and `/index.mdx`. Keep private content outside public content collections; `noindex` is not access control.
+- `draft: true` excludes unfinished pages from production. When adding a page, create its translation before publishing so the language switch remains valid.
+- Keep `nimbus.json` and `UPSTREAM.md` when upgrading. Review Nimbus migrations and project-owned changes before advancing the reviewed version.

package/templates/nimbus/LICENSE

@@ -0,0 +1,21 @@
+MIT License Copyright (c) 2025 Cloudflare, Inc.
+
+Permission is hereby granted, free of
+charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/templates/nimbus/README.md

@@ -0,0 +1,17 @@
+# Project docs / 项目文档
+
+A small bilingual Nimbus + Astro documentation site. 英文位于 `/`，中文位于 `/zh/`。
+
+From the monorepo root, run `corepack enable` and `pnpm install`. Then run these commands in this directory:
+
+```sh
+pnpm dev
+pnpm build
+pnpm preview
+pnpm lint
+pnpm typecheck
+```
+
+Edit `src/content/docs/` and its `zh/` translations. Set your project title and canonical site URL in `astro.config.ts` before publishing `dist/` to a static host. Search is available after a production build.
+
+机器可读入口包括 `/llms.txt`、`/zh/llms.txt`、`/llms-full.txt`，以及页面的 `/index.md` 和 `/index.mdx`。详见 `AGENTS.md` 和 `UPSTREAM.md`。

package/templates/nimbus/UPSTREAM.md

@@ -0,0 +1,16 @@
+# Upstream source
+
+This template adapts the static empty starter from [Cloudflare Nimbus](https://github.com/cloudflare/nimbus), released under the MIT license (see `LICENSE`).
+
+- Starter tag: `templates-v0.7.9`
+- Starter commit: `aae348048a8c659f84c39696ee6b20c2ad2f5ae2`
+- Nimbus package: `@cloudflare/nimbus-docs@0.15.2`
+- Astro: `7.3.1`
+
+Nimbus declares Astro `>=7.2.6 <8`; Astro requires Node `>=22.12.0`, so this workspace retains its stricter Node `>=22.13.0` baseline. Builds, Astro diagnostics and TypeScript checks were verified with the repository's TypeScript `6.0.3` and Vite `8.3.1` constraints. Resolved dependencies are recorded in the monorepo's root `pnpm-lock.yaml`; generated projects use their own root workspace lockfile.
+
+Agent endpoint routes and the content-loading approach come from that starter. The bilingual layout, navigation, search interface, examples and workspace checks are repoctl adaptations. These files are maintained locally; generating a project never downloads the upstream starter.
+
+The local head component emits page-specific language metadata because the upstream head uses the site-wide locale. Client scripts are emitted as external assets so Astro does not inline them before Vite finalizes Pagefind's dynamic import.
+
+The package version and starter tag were checked against published package metadata. `nimbus.json` records the reviewed package API baseline. The original full starter was not copied wholesale, so upstream starter diffs are not a claim that every local file is an unmodified upstream component.

package/templates/nimbus/astro.config.ts

@@ -0,0 +1,28 @@
+import nimbus, { defineConfig as defineNimbusConfig } from '@cloudflare/nimbus-docs'
+import { defineConfig } from 'astro/config'
+
+export default defineConfig({
+  output: 'static',
+  // Keep the Pagefind loader external so Vite finalizes dynamic imports before Astro renders it.
+  vite: { build: { assetsInlineLimit: 0 } },
+  integrations: [nimbus(defineNimbusConfig({
+    // Set your production origin before publishing.
+    site: 'https://docs.example.com',
+    title: 'Project docs',
+    description: 'Guides and examples for your project.',
+    locale: 'en',
+    github: null,
+  }), {
+    icons: false,
+    rules: {
+      'nimbus/frontmatter-shape': 'error',
+      'nimbus/internal-link': 'error',
+      'nimbus/single-h1': 'error',
+    },
+    markdown: {
+      componentMap: {
+        Aside: { revision: '1', render: ({ children }) => children },
+      },
+    },
+  })],
+})

package/templates/nimbus/eslint.config.js

@@ -0,0 +1,25 @@
+import astro from 'eslint-plugin-astro'
+import * as mdx from 'eslint-plugin-mdx'
+import { defineEslintConfig } from 'repoctl/tooling'
+
+const shared = await defineEslintConfig({ options: { astro: false, formatters: false } })
+
+// Markup has its own parser and formatter. Shared JS rules still check the
+// virtual TypeScript files extracted from Astro script blocks.
+const code = shared.map((config) => {
+  if (Object.keys(config).every(key => key === 'name' || key === 'ignores')) {
+    return config
+  }
+  return { ...config, ignores: [...(config.ignores ?? []), '**/*.astro', '**/*.mdx', '**/*.mdx/**'] }
+})
+
+export default [
+  ...code,
+  ...astro.configs['flat/recommended'],
+  {
+    ...mdx.flat,
+    files: ['**/*.mdx'],
+    languageOptions: { ...mdx.flat.languageOptions, globals: { Aside: 'readonly' } },
+  },
+  { ignores: ['.astro/**', '.nimbus/**', 'dist/**', '**/*.css'] },
+]

package/templates/nimbus/gitignore

@@ -0,0 +1,5 @@
+node_modules/
+dist/
+.astro/
+.nimbus/
+.turbo/

package/templates/nimbus/nimbus.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://nimbus-docs.com/schema/nimbus.json",
+  "lastReviewedNimbusVersion": "0.15.2"
+}

package/templates/nimbus/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@icebreakers/nimbus-template",
+  "type": "module",
+  "version": "0.0.0",
+  "private": true,
+  "description": "Bilingual Nimbus documentation starter",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "dev": "astro dev",
+    "build": "pnpm check:locales && astro build",
+    "preview": "astro preview",
+    "typecheck": "astro check && tsc --noEmit",
+    "lint": "eslint . && stylelint \"src/styles/**/*.css\" && nimbus-docs lint",
+    "lint:docs": "nimbus-docs lint",
+    "lint:docs:fix": "nimbus-docs lint --fix",
+    "check:locales": "node scripts/check-locales.mjs"
+  },
+  "dependencies": {
+    "@cloudflare/nimbus-docs": "0.15.2",
+    "astro": "7.3.5"
+  },
+  "devDependencies": {
+    "@astrojs/check": "^0.9.10",
+    "@astrojs/language-server": "2.17.1",
+    "astro-eslint-parser": "^3.2.0",
+    "eslint-plugin-astro": "^3.2.1",
+    "eslint-plugin-mdx": "^3.8.1",
+    "pagefind": "^1.5.2",
+    "typescript": "^6.0.3"
+  }
+}

package/templates/nimbus/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><rect width="32" height="32" rx="7" fill="#1d4ed8"/><path d="M9 8h10l4 4v12H9zM18 8v5h5M12 17h8M12 21h6" fill="none" stroke="white" stroke-width="1.6" stroke-linejoin="round"/></svg>

package/templates/nimbus/scripts/check-locales.mjs

@@ -0,0 +1,11 @@
+import assert from 'node:assert/strict'
+import { readdir } from 'node:fs/promises'
+import path from 'node:path'
+
+const content = new URL('../src/content/docs/', import.meta.url)
+const files = await readdir(content, { recursive: true })
+const pages = files.filter(file => /\.mdx?$/.test(file)).map(file => file.split(path.sep).join('/'))
+const english = pages.filter(file => !file.startsWith('zh/')).sort()
+const chinese = pages.filter(file => file.startsWith('zh/')).map(file => file.slice(3)).sort()
+assert.deepEqual(chinese, english, 'Every published page needs matching English and Chinese source files.')
+console.log(`Locale parity checked: ${english.length} page pairs.`)

package/templates/nimbus/src/components/aside.astro

@@ -0,0 +1,9 @@
+---
+interface Props { title?: string }
+const { title } = Astro.props
+---
+
+<aside class="callout">
+  {title && <strong>{title}</strong>}
+  <slot />
+</aside>

package/templates/nimbus/src/components/head.astro

@@ -0,0 +1,43 @@
+---
+import { withBase } from '@cloudflare/nimbus-docs/runtime'
+import { config } from 'virtual:nimbus/config'
+
+interface Props {
+  title: string
+  description?: string | undefined
+  markdownUrl?: string | undefined
+  noindex?: boolean | undefined
+  chinese: boolean
+}
+
+const { title, description = config.description, markdownUrl, noindex, chinese } = Astro.props
+const base = import.meta.env.BASE_URL
+const fullTitle = `${title} | ${config.title}`
+const language = chinese ? 'zh-CN' : 'en'
+const canonical = new URL(Astro.url.pathname, Astro.site)
+const structuredData = JSON.stringify({
+  '@context': 'https://schema.org',
+  '@type': 'WebPage',
+  'name': fullTitle,
+  description,
+  'url': canonical.href,
+  'inLanguage': language,
+})
+---
+
+<title>{fullTitle}</title>
+<meta name="generator" content={Astro.generator} />
+<meta name="description" content={description} />
+{noindex && <meta name="robots" content="noindex" />}
+<link rel="icon" type="image/svg+xml" href={withBase('/favicon.svg', base)} />
+<link rel="stylesheet" href={withBase('/_nimbus/shiki.css', base)} />
+<link rel="canonical" href={canonical} />
+<link rel="sitemap" href={withBase('/sitemap-index.xml', base)} />
+{markdownUrl && <link rel="alternate" type="text/markdown" href={new URL(withBase(markdownUrl, base), Astro.site)} />}
+<meta property="og:title" content={fullTitle} />
+<meta property="og:type" content="article" />
+<meta property="og:site_name" content={config.title} />
+<meta property="og:locale" content={chinese ? 'zh_CN' : 'en_US'} />
+<meta property="og:description" content={description} />
+<meta property="og:url" content={canonical} />
+<script type="application/ld+json" set:html={structuredData} />

package/templates/nimbus/src/components/search/client.ts

@@ -0,0 +1,62 @@
+interface SearchResult {
+  url: string
+  meta: { title?: string }
+}
+
+interface Pagefind {
+  init: () => Promise<void>
+  search: (query: string) => Promise<{ results: { data: () => Promise<SearchResult> }[] }>
+}
+
+// Pagefind is emitted by the Nimbus production build, not bundled by Vite.
+export function mountSearch(root: HTMLElement) {
+  const form = root.querySelector('form')!
+  const input = root.querySelector('input')!
+  const status = root.querySelector<HTMLElement>('[role="status"]')!
+  const results = root.querySelector('ul')!
+  let api: Promise<Pagefind> | undefined
+  let request = 0
+
+  form.addEventListener('submit', async (event) => {
+    event.preventDefault()
+    const current = ++request
+    results.replaceChildren()
+    const query = input.value.trim()
+    if (!query) {
+      status.textContent = ''
+      return
+    }
+    status.textContent = root.dataset.loading ?? ''
+    try {
+      const base = (root.dataset.base ?? '/').replace(/\/$/, '')
+      api ??= import(/* @vite-ignore */ `${base}/pagefind/pagefind.js`).then(async (module: Pagefind) => {
+        await module.init()
+        return module
+      })
+      const response = await (await api).search(query)
+      const pages = await Promise.all(response.results.slice(0, 10).map(result => result.data()))
+      if (current !== request) {
+        return
+      }
+      status.textContent = pages.length ? '' : root.dataset.empty ?? ''
+      for (const page of pages) {
+        const url = new URL(page.url, window.location.origin)
+        if (url.origin !== window.location.origin) {
+          continue
+        }
+        const item = document.createElement('li')
+        const link = document.createElement('a')
+        link.href = url.href
+        link.textContent = page.meta.title ?? page.url
+        item.append(link)
+        results.append(item)
+      }
+    }
+    catch {
+      api = undefined
+      if (current === request) {
+        status.textContent = root.dataset.unavailable ?? ''
+      }
+    }
+  })
+}

package/templates/nimbus/src/components/search/index.astro

@@ -0,0 +1,26 @@
+---
+import { labels } from '../../lib/locale'
+
+interface Props { chinese: boolean }
+const { chinese } = Astro.props
+const text = labels[chinese ? 'zh' : 'en']
+---
+
+<details class="search-panel" data-search data-base={import.meta.env.BASE_URL} data-loading={text.loading} data-empty={text.empty} data-unavailable={text.unavailable}>
+  <summary>{text.search}</summary>
+  <form role="search">
+    <label for="docs-search">{text.search}</label>
+    <div class="search-controls">
+      <input id="docs-search" name="query" type="search" required autocomplete="off" />
+      <button type="submit">{text.submit}</button>
+    </div>
+  </form>
+  <p role="status" aria-live="polite"></p>
+  <ul class="search-results"></ul>
+</details>
+
+<script>
+  import { mountSearch } from './client'
+
+  document.querySelectorAll<HTMLElement>('[data-search]').forEach(mountSearch)
+</script>

package/templates/nimbus/src/components/sidebar.astro

@@ -0,0 +1,26 @@
+---
+import type { SidebarItem } from '@cloudflare/nimbus-docs/types'
+import { withBase } from '@cloudflare/nimbus-docs/runtime'
+
+interface Props { items: SidebarItem[] }
+const { items } = Astro.props
+---
+
+<ul class="navigation-list">
+  {items.map(item => (
+    <li>
+      {item.type === 'group'
+        ? (
+            <>
+              {item.indexHref
+                ? <a href={withBase(item.indexHref, import.meta.env.BASE_URL)} aria-current={item.indexIsCurrent ? 'page' : undefined}>{item.label}</a>
+                : <span>{item.label}</span>}
+              <Astro.self items={item.children} />
+            </>
+          )
+        : (
+            <a href={withBase(item.href, import.meta.env.BASE_URL)} aria-current={item.type === 'link' && item.isCurrent ? 'page' : undefined}>{item.label}</a>
+          )}
+    </li>
+  ))}
+</ul>