@icebreakers/monorepo-templates 2.0.7 → 2.2.0

package/dist/{prepare-BapI8ioj.mjs → prepare-BYNSxvoB.mjs}

@@ -73,6 +73,14 @@ const templateChoices = [
 		category: "app",
 		description: "Vue 3 + Hono 的前后端一体应用模板"
 	},
+	{
+		key: "react-vite",
+		label: "React Vite 应用",
+		source: "react-vite",
+		target: "apps/react-vite",
+		category: "app",
+		description: "React + Vite + TypeScript 单页应用，包含交互测试与共享工程规范"
+	},
 	{
 		key: "hono-server",
 		label: "hono 模板",
@@ -96,6 +104,30 @@ const templateChoices = [
 		target: "apps/cli",
 		category: "tool",
 		description: "TypeScript 命令行工具模板"
+	},
+	{
+		key: "nimbus",
+		label: "Nimbus 文档（默认）",
+		source: "nimbus",
+		target: "apps/docs",
+		category: "docs",
+		description: "默认文档模板：Nimbus + Astro，中英双语与 AI 文档入口"
+	},
+	{
+		key: "react-lib",
+		label: "React 组件库",
+		source: "react-lib",
+		target: "packages/react-lib",
+		category: "library",
+		description: "带类型声明、显式 CSS 出口和发布消费验证的 React 组件库"
+	},
+	{
+		key: "next",
+		label: "Next.js App Router 应用",
+		source: "next",
+		target: "apps/next",
+		category: "app",
+		description: "Next.js + TypeScript SSR 应用，包含客户端交互、健康接口与工作区库集成"
 	}
 ];
 //#endregion
@@ -144,13 +176,17 @@ const skipDirs = /* @__PURE__ */ new Set([
 	".vite",
 	".tmp",
 	".vue-global-types",
-	".wrangler"
+	".wrangler",
+	".astro",
+	".nimbus",
+	".next"
 ]);
 const skipFiles = /* @__PURE__ */ new Set([
 	".DS_Store",
 	"CHANGELOG.md",
 	"route-map.d.ts",
-	"worker-configuration.d.ts"
+	"worker-configuration.d.ts",
+	"next-env.d.ts"
 ]);
 function shouldSkipTemplatePath(rootDir, targetPath) {
 	const basename = path.basename(targetPath);
@@ -169,12 +205,33 @@ function createTemplateCopyFilter(rootDir) {
 }
 //#endregion
 //#region src/prepare/published.ts
+const sourceScriptNames = /* @__PURE__ */ new Set([
+	"tooling:build",
+	"check:no-tracked-build-artifacts",
+	"check:workflows",
+	"test:dev-scenarios",
+	"test:worker-types"
+]);
+const isSourceOnlyScript = (name) => name.startsWith("dev:") || sourceScriptNames.has(name) || name.startsWith("test:packaged-");
 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",
+			"make-fetch-happen",
+			"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 (isSourceOnlyScript(name)) delete manifest.scripts[name];
 		manifest.scripts["dev"] = "turbo run dev --concurrency=20";
+		if (manifest.scripts["lint"]) manifest.scripts["lint"] = manifest.scripts["lint"].replace(/^pnpm run tooling:build && /u, "");
 		if (manifest.scripts["test"]) manifest.scripts["test"] = manifest.scripts["test"].replace(" && pnpm test:dev-scenarios", "");
+		for (const name of ["test", "test:dev"]) if (manifest.scripts[name]) manifest.scripts[name] = manifest.scripts[name].replace("pnpm check:no-tracked-build-artifacts && ", "");
 	}
 	return `${JSON.stringify(manifest, null, 2)}\n`;
 }
@@ -236,6 +293,40 @@ function sanitizePublishedWorkspaceContent(content) {
 	return changed ? YAML.stringify(workspace) : content;
 }
 //#endregion
+//#region src/prepare/workflows.ts
+function sourceCommand(command) {
+	if (/[;&|`$<>]/u.test(command)) return false;
+	const script = /^pnpm\s+(?:--[\w-]+(?:=[\w./:-]+)?\s+)*(?:run\s+(?:--[\w-]+(?:=[\w./:-]+)?\s+)*)?([\w:-]+)(?:\s|$)/u.exec(command)?.[1];
+	return script !== void 0 && isSourceOnlyScript(script) || /^pnpm\s+exec\s+playwright\s+install(?:\s|$)/u.test(command);
+}
+function mentionsSourceCommand(command) {
+	return command.split(/[^\w:-]+/u).some(isSourceOnlyScript) || /\bplaywright\s+install\b/u.test(command);
+}
+/** Filter YAML steps, so neighboring steps and additional fields cannot escape publication rules. */
+function sanitizePublishedCiWorkflowContent(content) {
+	const document = YAML.parseDocument(content);
+	if (document.errors.length) throw new Error("Cannot publish an invalid CI workflow.");
+	const jobs = document.get("jobs", true);
+	if (!YAML.isMap(jobs)) return content;
+	let changed = false;
+	for (const { value: job } of jobs.items) {
+		if (!YAML.isMap(job)) continue;
+		const steps = job.get("steps", true);
+		if (!YAML.isSeq(steps)) continue;
+		for (let index = steps.items.length - 1; index >= 0; index--) {
+			const step = steps.items[index];
+			const run = YAML.isMap(step) ? step.get("run") : void 0;
+			if (typeof run !== "string") continue;
+			const commands = run.split(/\r?\n/u).map((line) => line.trim()).filter((line) => line && !line.startsWith("#"));
+			if (!commands.some(mentionsSourceCommand)) continue;
+			if (!commands.every(sourceCommand)) throw new Error("Move source-only commands into separate CI steps before publishing templates.");
+			steps.delete(index);
+			changed = true;
+		}
+	}
+	return changed ? document.toString({ lineWidth: 0 }) : content;
+}
+//#endregion
 //#region src/prepare/index.ts
 const huskySkippedEntryPattern = /[\\/]_$/;
 function toPublishedAssetPath(target) {
@@ -357,10 +448,11 @@ async function removeSourceRepoReleaseToolingBuildStep() {
 	if (nextContent !== content) await fs.writeFile(releaseWorkflowPath, nextContent, "utf8");
 }
 async function removeSourceRepoChecks() {
+	await fs.rm(path$1.join(assetsDir, ".github/workflows/devcontainer.yml"), { force: true });
 	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, sanitizePublishedCiWorkflowContent(workflow));
 	}
 	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.7",
+  "version": "2.2.0",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
@@ -48,6 +48,7 @@
   "dependencies": {
     "@inquirer/checkbox": "^5.2.5",
     "@inquirer/input": "^5.1.6",
+    "@inquirer/password": "^5.2.2",
     "@inquirer/select": "^5.2.5",
     "commander": "^15.0.0",
     "nanoexec": "^1.1.0",

package/template-data.mjs

@@ -23,6 +23,14 @@ export const templateChoices = [
     category: 'app',
     description: 'Vue 3 + Hono 的前后端一体应用模板',
   },
+  {
+    key: 'react-vite',
+    label: 'React Vite 应用',
+    source: 'react-vite',
+    target: 'apps/react-vite',
+    category: 'app',
+    description: 'React + Vite + TypeScript 单页应用，包含交互测试与共享工程规范',
+  },
   {
     key: 'hono-server',
     label: 'hono 模板',
@@ -47,4 +55,28 @@ export const templateChoices = [
     category: 'tool',
     description: 'TypeScript 命令行工具模板',
   },
+  {
+    key: 'nimbus',
+    label: 'Nimbus 文档（默认）',
+    source: 'nimbus',
+    target: 'apps/docs',
+    category: 'docs',
+    description: '默认文档模板：Nimbus + Astro，中英双语与 AI 文档入口',
+  },
+  {
+    key: 'react-lib',
+    label: 'React 组件库',
+    source: 'react-lib',
+    target: 'packages/react-lib',
+    category: 'library',
+    description: '带类型声明、显式 CSS 出口和发布消费验证的 React 组件库',
+  },
+  {
+    key: 'next',
+    label: 'Next.js App Router 应用',
+    source: 'next',
+    target: 'apps/next',
+    category: 'app',
+    description: 'Next.js + TypeScript SSR 应用，包含客户端交互、健康接口与工作区库集成',
+  },
 ]

package/templates/client/package.json

@@ -60,10 +60,10 @@
     "@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",
+    "vite": "^8.3.2",
     "vite-plugin-vue-devtools": "^8.2.1",
     "vite-tsconfig-paths": "^6.1.1",
     "vue-tsc": "3.3.11",

package/templates/next/README.md

@@ -0,0 +1,31 @@
+# Next.js App Router workspace
+
+This TypeScript template follows `create-next-app@16.3.8`'s App Router layout and uses the shared repoctl tooling. It includes a server page, a client counter and `GET /api/health`. It requires Node 22.13 or newer and shares the workspace's pnpm version and lockfile.
+
+Run these from the generated workspace root:
+
+```sh
+corepack enable
+pnpm install
+pnpm build
+pnpm lint
+pnpm typecheck
+pnpm test
+pnpm --dir apps/next start
+```
+
+For development, run `pnpm --dir apps/next dev`. When created with `repo new portal --template next`, use `apps/portal` instead. Lint runs ESLint and Stylelint independently of Next build. `typecheck` runs `next typegen` before `tsc --noEmit`, so route types exist even before the first production build. Unit tests cover client state; the repoctl source repository also tests the built server and browser using actual published tarballs.
+
+## Internal packages
+
+For a compiled workspace library, add `"@acme/shared": "workspace:*"` to dependencies and import its public package name. The library should expose its built JavaScript and declaration files through `exports`. Turbo's inherited `^build` builds the library first; do not reach into another package's source via relative imports.
+
+To consume an intentionally source-exporting TypeScript package, add its package name to `transpilePackages` in `next.config.ts`. Its exports and server/client compatibility must support the target environment. `transpilePackages` does not generate that library's standalone declaration files, and server-only code must not enter a client component. The packaged acceptance test covers both compiled and source-exporting internal packages.
+
+## Cache and runtime boundaries
+
+The local `turbo.json` includes all authored app inputs and caches `.next/**` except `.next/cache/**`. Development and production server tasks are persistent and uncached; type generation is uncached to keep Next's generated route declarations available. `.next`, `next-env.d.ts`, and TypeScript build info are generated locally and never shipped as template inputs.
+
+No external font download is needed to build this starter. Configure environment values and production hosting for your application separately; no authentication, database or deployment platform is included.
+
+References: [create-next-app](https://nextjs.org/docs/app/api-reference/cli/create-next-app), [Next CLI and typegen](https://nextjs.org/docs/app/api-reference/cli/next), [transpilePackages](https://nextjs.org/docs/app/api-reference/config/next-config-js/transpilePackages).

package/templates/next/eslint.config.js

@@ -0,0 +1,5 @@
+import { defineEslintConfig } from 'repoctl/tooling'
+
+export default await defineEslintConfig({
+  options: { react: true, typescript: true, ignores: ['.next/**', 'next-env.d.ts'] },
+})

package/templates/next/gitignore

@@ -0,0 +1,7 @@
+.next/
+node_modules/
+next-env.d.ts
+*.tsbuildinfo
+coverage/
+.env*
+!.env.example

package/templates/next/next.config.ts

@@ -0,0 +1,5 @@
+import type { NextConfig } from 'next'
+
+const nextConfig: NextConfig = {}
+
+export default nextConfig

package/templates/next/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@icebreakers/next-template",
+  "type": "module",
+  "version": "0.0.0",
+  "private": true,
+  "description": "Internal Next.js App Router and TypeScript application template shipped with repoctl",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint . && stylelint \"src/**/*.css\"",
+    "lint:fix": "eslint . --fix && stylelint \"src/**/*.css\" --fix",
+    "typecheck": "next typegen && tsc --noEmit",
+    "test": "vitest run",
+    "test:dev": "vitest"
+  },
+  "dependencies": {
+    "next": "16.3.8",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-react": "^6.1.1",
+    "jsdom": "^30.1.1",
+    "typescript": "~6.0.3",
+    "vitest": "~5.0.3"
+  }
+}

package/templates/next/src/app/api/health/route.ts

@@ -0,0 +1,5 @@
+export const dynamic = 'force-dynamic'
+
+export function GET() {
+  return Response.json({ status: 'ok' }, { headers: { 'Cache-Control': 'no-store' } })
+}

package/templates/next/src/app/counter.tsx

@@ -0,0 +1,19 @@
+'use client'
+
+import { useState } from 'react'
+
+export default function Counter() {
+  const [count, setCount] = useState(0)
+  return (
+    <section className="counter" aria-label="Client interaction">
+      <div>
+        <p className="eyebrow">Client state</p>
+        <output aria-label="Count" aria-live="polite">{count}</output>
+      </div>
+      <div className="actions">
+        <button type="button" onClick={() => setCount(value => value + 1)}>Add one</button>
+        <button type="button" className="secondary" disabled={count === 0} onClick={() => setCount(0)}>Reset</button>
+      </div>
+    </section>
+  )
+}

package/templates/next/src/app/globals.css

@@ -0,0 +1,109 @@
+@charset "UTF-8";
+
+:root {
+  font-family: Arial, Helvetica, sans-serif;
+  font-synthesis: none;
+  color: #1b263b;
+  background: #f5f3ee;
+  text-rendering: optimizelegibility;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+}
+
+main {
+  width: min(100% - 3rem, 48rem);
+  margin: 12vh auto;
+}
+
+.eyebrow {
+  margin: 0 0 1.5rem;
+  font-size: 0.75rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.12em;
+}
+
+h1 {
+  margin: 0 0 1.5rem;
+  font-size: clamp(2.5rem, 7vw, 4.5rem);
+  line-height: 1.05;
+  letter-spacing: -0.05em;
+}
+
+.intro {
+  max-width: 35rem;
+  font-size: 1.125rem;
+  line-height: 1.7;
+  color: #536073;
+}
+
+.counter {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 2rem;
+  align-items: center;
+  justify-content: space-between;
+  padding: 2rem 0;
+  margin: 3rem 0;
+  border-block: 1px solid #c7cbd1;
+}
+
+.counter .eyebrow {
+  margin-bottom: 0.75rem;
+}
+
+output {
+  font-size: 3rem;
+  font-variant-numeric: tabular-nums;
+}
+
+.actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+}
+
+button {
+  min-height: 2.75rem;
+  padding: 0.75rem 1.125rem;
+  font: inherit;
+  color: #fff;
+  cursor: pointer;
+  background: #1b263b;
+  border: 1px solid #1b263b;
+  border-radius: 0.25rem;
+}
+
+.secondary {
+  color: #1b263b;
+  background: transparent;
+}
+
+button:disabled {
+  cursor: default;
+  opacity: 0.45;
+}
+
+button:focus-visible,
+a:focus-visible {
+  outline: 3px solid #b95732;
+  outline-offset: 4px;
+}
+
+footer {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 1rem 2rem;
+  font-size: 0.875rem;
+}
+
+a {
+  color: inherit;
+  text-underline-offset: 0.25em;
+}

package/templates/next/src/app/layout.tsx

@@ -0,0 +1,17 @@
+/* eslint react-refresh/only-export-components: ["error", { "allowExportNames": ["metadata"] }] -- Next.js reads metadata from route layouts. */
+import type { Metadata } from 'next'
+import type { ReactNode } from 'react'
+import './globals.css'
+
+export const metadata: Metadata = {
+  title: 'Next.js workspace',
+  description: 'A Next.js App Router application in your pnpm workspace.',
+}
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}

package/templates/next/src/app/page.tsx

@@ -0,0 +1,16 @@
+import Counter from './counter'
+
+export default function HomePage() {
+  return (
+    <main>
+      <p className="eyebrow">repoctl / Next.js</p>
+      <h1>Next.js workspace</h1>
+      <p className="intro">A server-rendered page with a small client component. Ready for your next feature.</p>
+      <Counter />
+      <footer>
+        <a href="/api/health">Health endpoint</a>
+        <a href="https://nextjs.org/docs/app">App Router documentation</a>
+      </footer>
+    </main>
+  )
+}

package/templates/next/stylelint.config.js

@@ -0,0 +1,3 @@
+import { defineStylelintConfig } from 'repoctl/tooling'
+
+export default await defineStylelintConfig()

package/templates/next/test/counter.test.tsx

@@ -0,0 +1,22 @@
+import { cleanup, fireEvent, render, screen } from '@testing-library/react'
+import { afterEach, expect, it } from 'vitest'
+import Counter from '../src/app/counter'
+
+afterEach(cleanup)
+
+it('increments the count and resets it to zero', () => {
+  render(<Counter />)
+  const count = screen.getByLabelText('Count')
+  const reset = screen.getByRole('button', { name: 'Reset' })
+  expect(count.textContent).toBe('0')
+  expect(reset.hasAttribute('disabled')).toBe(true)
+
+  fireEvent.click(screen.getByRole('button', { name: 'Add one' }))
+  fireEvent.click(screen.getByRole('button', { name: 'Add one' }))
+  expect(count.textContent).toBe('2')
+  expect(reset.hasAttribute('disabled')).toBe(false)
+
+  fireEvent.click(reset)
+  expect(count.textContent).toBe('0')
+  expect(reset.hasAttribute('disabled')).toBe(true)
+})

package/templates/next/tsconfig.json

@@ -0,0 +1,40 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "incremental": true,
+    "tsBuildInfoFile": "./node_modules/.tmp/next.tsbuildinfo",
+    "target": "ES2022",
+    "jsx": "react-jsx",
+    "lib": [
+      "DOM",
+      "DOM.Iterable",
+      "ESNext"
+    ],
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ]
+    },
+    "types": [
+      "node"
+    ],
+    "isolatedModules": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "next-env.d.ts",
+    "src/**/*.ts",
+    "src/**/*.tsx",
+    "test/**/*.tsx",
+    "next.config.ts",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/templates/next/turbo.json

@@ -0,0 +1,24 @@
+{
+  "extends": [
+    "//"
+  ],
+  "tasks": {
+    "build": {
+      "inputs": [
+        "$TURBO_DEFAULT$",
+        ".env*"
+      ],
+      "outputs": [
+        ".next/**",
+        "!.next/cache/**"
+      ]
+    },
+    "typecheck": {
+      "cache": false
+    },
+    "start": {
+      "cache": false,
+      "persistent": true
+    }
+  }
+}

package/templates/next/vitest.config.js

@@ -0,0 +1,9 @@
+import react from '@vitejs/plugin-react'
+import { defineVitestProjectConfig } from 'repoctl/tooling'
+import { mergeConfig } from 'vitest/config'
+
+export default mergeConfig(await defineVitestProjectConfig({
+  options: { environment: 'jsdom' },
+}), {
+  plugins: [react()],
+})

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`。