@icebreakers/monorepo-templates 1.3.5 → 2.0.1

package/dist/cli.mjs

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

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as toPublishGitignorePath, c as assetsDir, d as templatesDir, f as assetTargets$1, i as isGitignoreFile, l as packageDir, n as createTemplateCopyFilter, o as toWorkspaceGitignorePath, p as getAssetTargets$1, r as shouldSkipTemplatePath, s as templateChoices$1, t as prepareAssets, u as skeletonDir } from "./prepare-DlR-vvls.mjs";
+import { a as toPublishGitignorePath, c as assetsDir, d as templatesDir, f as assetTargets$1, i as isGitignoreFile, l as packageDir, n as createTemplateCopyFilter, o as toWorkspaceGitignorePath, p as getAssetTargets$1, r as shouldSkipTemplatePath, s as templateChoices$1, t as prepareAssets, u as skeletonDir } from "./prepare-zIcRa4-K.mjs";
 import path from "node:path";
 import fs, { access, open, rm } from "node:fs/promises";
 import exec from "nanoexec";

package/dist/{prepare-DlR-vvls.mjs → prepare-zIcRa4-K.mjs}

@@ -19,6 +19,8 @@ const coreAssetTargets = [
 	"repoctl.config.ts",
 	"package.json",
 	"AGENTS.md",
+	"CLAUDE.md",
+	".agents",
 	"pnpm-workspace.yaml",
 	"tsconfig.json",
 	"turbo.json",
@@ -204,11 +206,23 @@ function removeSourceRepoReleaseToolingBuildStepContent(content) {
 }
 function sanitizePublishedWorkspaceContent(content) {
 	const workspace = YAML.parse(content);
-	if (!workspace?.versioning || typeof workspace.versioning !== "object") return content;
-	delete workspace.versioning["fixed"];
-	delete workspace.versioning["ignore"];
-	delete workspace.versioning["lanes"];
-	return YAML.stringify(workspace);
+	if (!workspace || typeof workspace !== "object") return content;
+	let changed = false;
+	if (workspace.versioning && typeof workspace.versioning === "object") {
+		delete workspace.versioning["fixed"];
+		delete workspace.versioning["ignore"];
+		delete workspace.versioning["lanes"];
+		changed = true;
+	}
+	if ("catalog" in workspace) {
+		delete workspace.catalog;
+		changed = true;
+	}
+	if ("catalogs" in workspace) {
+		delete workspace.catalogs;
+		changed = true;
+	}
+	return changed ? YAML.stringify(workspace) : content;
 }
 async function pathExists(targetPath) {
 	try {
@@ -272,12 +286,13 @@ async function copyEntry(from, to, overwriteExisting, filter) {
 		throw error;
 	}
 }
+const publishedAgentSourceFiles = /* @__PURE__ */ new Set(["AGENTS.md", "CLAUDE.md"]);
 async function copyAssets(repoRoot, overwriteExisting) {
 	const monorepoAssetRoot = path$1.resolve(repoRoot, "packages/monorepo/assets");
 	for (const target of assetTargets) {
 		const packageAsset = path$1.join(monorepoAssetRoot, toPublishGitignorePath(target));
 		const repoAsset = path$1.join(repoRoot, target);
-		const from = await pathExists(repoAsset) ? repoAsset : packageAsset;
+		const from = publishedAgentSourceFiles.has(target) || !await pathExists(repoAsset) ? packageAsset : repoAsset;
 		if (!await pathExists(from)) continue;
 		const to = path$1.join(assetsDir, toPublishGitignorePath(target));
 		const stats = await fs.stat(from);
@@ -295,6 +310,11 @@ async function writePublishedToolingConfigs() {
 		if (await pathExists(targetPath)) await fs.writeFile(targetPath, content);
 	}));
 }
+async function writePublishedAgentSkill(repoRoot, overwriteExisting) {
+	const skillFrom = path$1.join(repoRoot, "packages/monorepo/resources/skills/repoctl");
+	if (!await pathExists(skillFrom)) return;
+	await copyEntry(skillFrom, path$1.join(assetsDir, ".agents", "skills", "repoctl"), overwriteExisting);
+}
 async function sanitizePublishedWorkspace() {
 	const workspacePath = path$1.join(assetsDir, "pnpm-workspace.yaml");
 	if (!await pathExists(workspacePath)) return;
@@ -344,6 +364,7 @@ async function prepareAssets(options = {}) {
 	await sanitizePublishedWorkspace();
 	await removePublishedReleaseState();
 	await writePublishedToolingConfigs();
+	await writePublishedAgentSkill(repoRoot, overwriteExisting);
 	await removeSourceRepoReleaseToolingBuildStep();
 	await removeSourceRepoWorkerTypeChecks();
 	await copyTemplates(repoRoot, overwriteExisting);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo-templates",
   "type": "module",
-  "version": "1.3.5",
+  "version": "2.0.1",
   "description": "Built-in project templates and managed workspace assets for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
   "license": "MIT",
@@ -35,6 +35,7 @@
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "files": [
+    "README.md",
     "assets",
     "assets-data.mjs",
     "dist",
@@ -42,7 +43,7 @@
     "templates"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.13.0"
   },
   "dependencies": {
     "@inquirer/checkbox": "^5.2.5",
@@ -50,10 +51,11 @@
     "@inquirer/select": "^5.2.5",
     "commander": "^15.0.0",
     "nanoexec": "^1.1.0",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.1"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "scripts": {
     "dev": "tsdown --watch --sourcemap",

package/templates/cli/dev/index.ts

@@ -1,2 +1,4 @@
-#!/usr/bin/env -S npx tsx
-import '../src/cli.ts'
+#!/usr/bin/env -S node --experimental-strip-types
+import { runCli } from '../src/index.ts'
+
+runCli()

package/templates/cli/package.json

@@ -24,8 +24,11 @@
   "bin": {
     "ice": "./dev/index.ts"
   },
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
-    "start": "tsx src/index.ts",
+    "start": "node --experimental-strip-types src/index.ts",
     "dev": "tsdown --watch --sourcemap",
     "build": "tsdown",
     "lint": "eslint .",

package/templates/client/package.json

@@ -4,6 +4,8 @@
   "version": "0.0.1",
   "private": true,
   "description": "Internal Vue and Cloudflare application template shipped with repoctl",
+  "author": "ice breaker <hi@sonofmagic.top>",
+  "license": "MIT",
   "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
@@ -19,6 +21,9 @@
     "cloudflare",
     "template"
   ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "dev": "pnpm cf-typegen && vite --host",
     "build": "pnpm cf-typegen && vue-tsc -b && vite build",
@@ -32,37 +37,37 @@
   },
   "dependencies": {
     "@faker-js/faker": "^10.6.0",
-    "@tanstack/vue-query": "^5.102.8",
-    "@tanstack/vue-query-devtools": "^6.1.48",
+    "@tanstack/vue-query": "^5.103.1",
+    "@tanstack/vue-query-devtools": "^6.2.1",
     "@tanstack/vue-table": "^9.2.4",
-    "@tanstack/vue-virtual": "^3.13.37",
-    "@trpc/client": "^11.18.0",
+    "@tanstack/vue-virtual": "^3.13.39",
+    "@trpc/client": "^11.19.0",
     "clsx": "^2.1.1",
     "pinia": "^4.0.3",
-    "tailwind-merge": "^3.6.0",
+    "tailwind-merge": "^3.7.0",
     "tailwind-variants": "^3.3.1",
-    "vue": "^3.5.42",
-    "vue-i18n": "^11.4.10",
+    "vue": "^3.5.43",
+    "vue-i18n": "^11.4.12",
     "vue-router": "^5.3.1"
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "^1.54.5",
+    "@cloudflare/vite-plugin": "^1.54.11",
     "@hono/node-server": "^2.1.1",
     "@hono/trpc-server": "^0.4.2",
     "@tailwindcss/vite": "^4.3.3",
-    "@trpc/server": "^11.18.0",
-    "@vitejs/plugin-vue": "^6.0.8",
+    "@trpc/server": "^11.19.0",
+    "@vitejs/plugin-vue": "^6.0.9",
     "@vitejs/plugin-vue-jsx": "^5.1.6",
     "@vue/tsconfig": "^0.9.1",
     "consola": "^3.4.2",
-    "hono": "^4.13.7",
+    "hono": "^4.13.8",
     "tailwindcss": "^4.3.3",
     "typescript": "~6.0.3",
-    "vite": "^8.2.2",
+    "vite": "^8.3.0",
     "vite-plugin-vue-devtools": "^8.2.1",
     "vite-tsconfig-paths": "^6.1.1",
     "vue-tsc": "3.3.11",
-    "wrangler": "^4.129.1",
-    "zod": "^4.5.4"
+    "wrangler": "^4.133.0",
+    "zod": "^4.6.5"
   }
 }

package/templates/server/package.json

@@ -30,13 +30,16 @@
   "files": [
     "dist"
   ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "dev": "pnpm cf-typegen && wrangler dev",
     "build": "pnpm cf-typegen && tsdown",
     "build:watch": "tsdown --watch --sourcemap",
     "node:build:watch": "pnpm build:watch",
     "node:build": "pnpm build",
-    "node:dev": "tsx watch src/node-entry.ts",
+    "node:dev": "node --watch --experimental-strip-types src/node-entry.ts",
     "node:start": "node dist/node-entry.mjs",
     "test": "vitest run",
     "test:dev": "vitest",
@@ -63,9 +66,9 @@
   "devDependencies": {
     "@hono/node-server": "^2.1.1",
     "consola": "^3.4.2",
-    "hono": "^4.13.7",
+    "hono": "^4.13.8",
     "tsdown": "0.23.0",
-    "wrangler": "^4.129.1",
-    "zod": "^4.5.4"
+    "wrangler": "^4.133.0",
+    "zod": "^4.6.5"
   }
 }

package/templates/server/src/node-entry.ts

@@ -1,8 +1,8 @@
 import { serve } from '@hono/node-server'
 import { consola } from 'consola'
 import { logger } from 'hono/logger'
-import { app } from './app'
-import { port } from './config'
+import { app } from './app.ts'
+import { port } from './config.ts'
 
 app.use(logger())
 serve({

package/templates/server/tsconfig.json

@@ -12,7 +12,8 @@
     "types": [
       "node",
       "vitest/globals"
-    ]
+    ],
+    "allowImportingTsExtensions": true
   },
   "include": [
     "src",

package/templates/tsdown/package.json

@@ -41,6 +41,10 @@
   "files": [
     "dist"
   ],
+  "publishConfig": {},
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "dev": "tsdown -w",
     "build": "tsdown",
@@ -51,6 +55,5 @@
     "lint:fix": "eslint . --fix",
     "typecheck": "tsc -p tsconfig.json",
     "tsd": "pnpm build && tsd --files test-d/**/*.test-d.ts"
-  },
-  "publishConfig": {}
+  }
 }

package/templates/vitepress/.vitepress/config.ts

@@ -9,6 +9,7 @@ export default withMermaid(defineConfig({
   outDir: '.vitepress/dist',
   srcExclude: ['CHANGELOG.md', 'learn/packages/examples/**', 'zh/learn/packages/examples/**'],
   title: 'repoctl',
+  titleTemplate: ':title — Official CLI for pnpm and Turborepo Monorepos',
   description: 'A practical CLI guide for setting up, checking, and maintaining pnpm and Turborepo monorepos.',
   lastUpdated: true,
   cleanUrls: true,

package/templates/vitepress/.vitepress/seo.ts

@@ -29,6 +29,14 @@ export function createPageHead({ page, title, description }: TransformContext):
   const socialImageAlt = isChinese
     ? 'repoctl：面向 pnpm 与 Turborepo monorepo 的任务型 CLI'
     : 'repoctl: task-first CLI for pnpm and Turborepo monorepos'
+  const jsonLd = {
+    '@context': 'https://schema.org',
+    '@graph': [
+      { '@type': 'Organization', 'name': 'repoctl', 'url': siteOrigin, 'logo': `${siteOrigin}/brand/repoctl-mark.svg`, 'sameAs': ['https://github.com/sonofmagic/repoctl', 'https://www.npmjs.com/package/repoctl'] },
+      { '@type': 'SoftwareApplication', 'name': 'repoctl', 'applicationCategory': 'DeveloperApplication', 'operatingSystem': 'macOS, Linux, Windows', 'url': siteOrigin, description, 'sameAs': ['https://github.com/sonofmagic/repoctl', 'https://www.npmjs.com/package/repoctl'], 'offers': { '@type': 'Offer', 'price': '0', 'priceCurrency': 'USD' } },
+      { '@type': 'WebSite', 'name': 'repoctl', 'url': siteOrigin, 'potentialAction': { '@type': 'SearchAction', 'target': `${siteOrigin}/reference/commands?q={search_term_string}`, 'query-input': 'required name=search_term_string' } },
+    ],
+  }
 
   return [
     ['link', { rel: 'canonical', href: canonical }],
@@ -45,10 +53,14 @@ export function createPageHead({ page, title, description }: TransformContext):
     ['meta', { property: 'og:image:width', content: '1200' }],
     ['meta', { property: 'og:image:height', content: '630' }],
     ['meta', { property: 'og:image:alt', content: socialImageAlt }],
+    ['meta', { property: 'og:image:type', content: 'image/png' }],
+    ['meta', { name: 'author', content: 'repoctl contributors' }],
+    ['meta', { name: 'application-name', content: 'repoctl' }],
     ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
     ['meta', { name: 'twitter:title', content: title }],
     ['meta', { name: 'twitter:description', content: description }],
     ['meta', { name: 'twitter:image', content: socialImage }],
     ['meta', { name: 'twitter:image:alt', content: socialImageAlt }],
+    ['script', { type: 'application/ld+json' }, JSON.stringify(jsonLd)],
   ]
 }

package/templates/vitepress/.vitepress/theme/components/HomePage.vue

@@ -5,6 +5,19 @@ import { homeContent } from '../../home/content'
 
 const props = defineProps<{ locale: DocsLocale }>()
 const content = computed(() => homeContent[props.locale])
+const faq = computed(() => props.locale === 'zh'
+  ? [
+      ['repoctl 是什么？', 'repoctl 是面向 pnpm 与 Turborepo monorepo 的任务型 CLI，用于初始化、诊断、创建、校验和发布工作区。'],
+      ['如何安装 repoctl？', '在项目中运行 pnpm add -D repoctl，然后使用 pnpm exec repo init 和 pnpm exec repo doctor。'],
+      ['repoctl 与 pnpm、Turborepo 是什么关系？', 'pnpm 和 Turborepo 负责包管理与任务编排，repoctl 负责把团队约定、检查和日常操作组织成可复用任务。'],
+      ['repo doctor 与 repo check 有什么区别？', 'repo doctor 诊断仓库健康状况，repo check 规划并执行 lint、类型、构建和测试校验。'],
+    ]
+  : [
+      ['What is repoctl?', 'repoctl is a task-first CLI for initializing, diagnosing, creating, checking, and releasing pnpm and Turborepo monorepos.'],
+      ['How do I install repoctl?', 'Run pnpm add -D repoctl, then use pnpm exec repo init and pnpm exec repo doctor.'],
+      ['How does repoctl relate to pnpm and Turborepo?', 'pnpm and Turborepo provide package management and task orchestration; repoctl turns repository conventions and checks into reusable tasks.'],
+      ['What is the difference between repo doctor and repo check?', 'repo doctor diagnoses repository health, while repo check plans and runs lint, type, build, and test checks.'],
+    ])
 </script>
 
 <template>
@@ -108,5 +121,17 @@ const content = computed(() => homeContent[props.locale])
         </a>
       </div>
     </section>
+    <section class="repoctl-home__section repoctl-home__faq" aria-labelledby="repoctl-faq-title">
+      <h2 id="repoctl-faq-title">
+        {{ props.locale === 'zh' ? '常见问题' : 'Frequently asked questions' }}
+      </h2>
+      <details v-for="item in faq" :key="item[0]">
+        <summary>{{ item[0] }}</summary>
+        <p>{{ item[1] }}</p>
+      </details>
+      <script type="application/ld+json">
+        {{ JSON.stringify({ '@context': 'https://schema.org', '@type': 'FAQPage', "mainEntity": faq.map(item => ({ '@type': 'Question', "name": item[0], "acceptedAnswer": { '@type': 'Answer', "text": item[1] } })) }) }}
+      </script>
+    </section>
   </main>
 </template>

package/templates/vitepress/ai/create.md

@@ -0,0 +1,45 @@
+---
+description: Non-interactive recipe for AI agents to create a repoctl workspace with pnpm create repoctl --yes.
+outline: deep
+---
+
+# Create a project with repoctl (AI)
+
+Use this page when an agent is asked to create a new project with repoctl.
+
+## Empty directory
+
+Do not prompt. Run:
+
+```bash
+pnpm create repoctl <dir> -- --yes --templates <keys>
+cd <dir>
+pnpm install
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+`npm create repoctl@latest <dir> -- --yes --templates <keys>` and
+`npx create-repoctl <dir> --yes --templates <keys>` are equivalent.
+`pnpm create` and `npm create` need the extra `--` before flags.
+
+## Template keys
+
+| User intent              | `--templates` / `repo new --template` |
+| ------------------------ | ------------------------------------- |
+| Vue / full-stack web app | `vue-hono`                            |
+| API / Hono service       | `hono-server`                         |
+| TypeScript library / SDK | `tsdown`                              |
+| Vue component library    | `vue-lib`                             |
+| Documentation site       | `vitepress`                           |
+| CLI                      | `cli`                                 |
+
+Omit `--templates` when the intent is unclear. After init, create a package with:
+
+```bash
+pnpm exec repo new <name> --template <key>
+```
+
+## Existing workspace
+
+If `pnpm-workspace.yaml` and a `repoctl` dependency already exist, do not run create. Use `repo new` instead, then `pnpm exec repo check`.

package/templates/vitepress/ai/index.md

@@ -4,6 +4,18 @@ outline: deep
 
 # AI Documentation
 
+## Product facts
+
+| Field         | Value                                                |
+| ------------- | ---------------------------------------------------- |
+| Product       | repoctl, task-first CLI for monorepos                |
+| Official site | https://repoctl.icebreaker.top                       |
+| Source        | https://github.com/sonofmagic/repoctl                |
+| npm package   | `repoctl` — https://www.npmjs.com/package/repoctl    |
+| Install       | `pnpm add -D repoctl`                                |
+| Core commands | `repo init`, `repo doctor`, `repo new`, `repo check` |
+| Works with    | pnpm workspaces and Turborepo                        |
+
 repoctl publishes AI-readable documentation alongside the human site.
 
 ## Recommended Entrypoints
@@ -11,6 +23,7 @@ repoctl publishes AI-readable documentation alongside the human site.
 - `/llms.txt`: compact English index and product summary.
 - `/llms-full.txt`: combined page content when a larger context is appropriate.
 - `/zh/`: Simplified Chinese documentation.
+- [Create a project](./create.md): non-interactive `pnpm create repoctl --yes` recipe.
 - [llms.txt Guide](./llms-txt.md): usage and maintenance rules.
 
 ## Using It In AI Tools

package/templates/vitepress/index.md

@@ -2,7 +2,7 @@
 layout: page
 aside: false
 pageClass: repoctl-home-page
-title: repoctl
+title: repoctl Official Monorepo CLI
 description: Task-first CLI for initializing, maintaining, validating, and releasing pnpm and Turborepo monorepos.
 ---
 

package/templates/vitepress/learn/tools/repoctl-vs-pnpm-turborepo.md

@@ -0,0 +1,16 @@
+---
+title: repoctl, pnpm, and Turborepo
+description: Understand how repoctl complements pnpm and Turborepo in a modern monorepo toolchain.
+---
+
+# repoctl, pnpm, and Turborepo
+
+pnpm manages packages and dependencies. Turborepo orchestrates tasks and caching. repoctl provides repository workflows, conventions, diagnostics, templates, checks, reports, and release steps.
+
+| Tool      | Primary responsibility                       |
+| --------- | -------------------------------------------- |
+| pnpm      | Workspace packages and dependency management |
+| Turborepo | Task pipelines and caching                   |
+| repoctl   | Repository operations and guided checks      |
+
+See [what repoctl is](/start/what-is-repoctl) and [install repoctl](/start/install-repoctl).

package/templates/vitepress/package.json

@@ -5,6 +5,7 @@
   "private": true,
   "description": "Documentation website for repoctl",
   "author": "ice breaker <hi@sonofmagic.top>",
+  "license": "MIT",
   "homepage": "https://repoctl.icebreaker.top",
   "repository": {
     "type": "git",
@@ -20,9 +21,12 @@
     "vitepress",
     "monorepo"
   ],
+  "engines": {
+    "node": ">=22.13.0"
+  },
   "scripts": {
     "dev": "vitepress dev",
-    "check:locales": "tsx scripts/check-locales.ts",
+    "check:locales": "node --experimental-strip-types scripts/check-locales.ts",
     "build": "pnpm run check:locales && vitepress build",
     "preview": "vitepress preview",
     "deploy": "wrangler deploy",
@@ -33,7 +37,7 @@
     "typecheck": "vue-tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "vue": "^3.5.42"
+    "vue": "^3.5.43"
   },
   "devDependencies": {
     "@braintree/sanitize-url": "^7.1.2",
@@ -42,13 +46,12 @@
     "cytoscape-cose-bilkent": "^4.1.0",
     "dayjs": "^1.11.23",
     "debug": "^4.4.3",
-    "mermaid": "^11.17.2",
+    "mermaid": "^12.0.0",
     "tailwindcss": "^4.3.3",
-    "tsx": "^4.23.13",
     "vitepress": "^1.6.4",
-    "vitepress-plugin-llms": "^1.13.5",
+    "vitepress-plugin-llms": "^1.14.0",
     "vitepress-plugin-mermaid": "^2.0.17",
     "vue-tsc": "^3.3.11",
-    "wrangler": "^4.129.1"
+    "wrangler": "^4.133.0"
   }
 }

package/templates/vitepress/public/robots.txt

@@ -0,0 +1,5 @@
+User-agent: *
+Allow: /
+Disallow: /_headers
+
+Sitemap: https://repoctl.icebreaker.top/sitemap.xml

package/templates/vitepress/scripts/check-locales.ts

@@ -2,8 +2,8 @@ import type { DocsLocale } from '../.vitepress/navigation/routes'
 import { readdir, readFile, stat } from 'node:fs/promises'
 import path from 'node:path'
 import process from 'node:process'
-import { homeContent } from '../.vitepress/home/content'
-import { routePath, routeSections } from '../.vitepress/navigation/routes'
+import { homeContent } from '../.vitepress/home/content.ts'
+import { routePath, routeSections } from '../.vitepress/navigation/routes.ts'
 
 const root = process.cwd()
 const ignoredDirectories = new Set(['.vitepress', 'node_modules'])

package/templates/vitepress/start/index.md

@@ -5,6 +5,8 @@ Use this section when repoctl is new to you. The shortest useful path is to inst
 ## Pick your first move
 
 - [Install and initialize](./install.md) if this is your first repoctl command.
+- [What is repoctl?](./what-is-repoctl.md) for the product overview.
+- [Install repoctl](./install-repoctl.md) for the shortest setup path.
 - [Run the first diagnosis](./diagnose.md) if repoctl is already installed.
 - [Choose the next task](./choose-next.md) after you have a diagnosis.
 
@@ -23,4 +25,4 @@ The CLI works with pnpm workspaces and understands Turborepo task graphs. It doe
 
 ## Before you continue
 
-You need Node.js 22.12 or newer and pnpm available on your path. Run commands from the repository root so repoctl can read the workspace configuration.
+You need Node.js 22.13 or newer and pnpm available on your path. Run commands from the repository root so repoctl can read the workspace configuration.

package/templates/vitepress/start/install-repoctl.md

@@ -0,0 +1,16 @@
+---
+title: Install repoctl
+description: Install repoctl in a pnpm monorepo, initialize managed defaults, and run your first repository diagnosis.
+---
+
+# Install repoctl
+
+Install repoctl as a development dependency so every teammate and CI job uses the same version.
+
+```bash
+pnpm add -D repoctl
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+Continue with [checks](/tasks/checks) or [adopting an existing workspace](/tasks/adopt-existing).

package/templates/vitepress/start/install.md

@@ -4,7 +4,7 @@ This guide follows the order you would use when adding repoctl to a workspace.
 
 ## Prerequisites
 
-- Node.js 20 or newer.
+- Node.js 22.13 or newer.
 - pnpm. Corepack is recommended: `corepack enable`.
 - Git. `repo doctor` reads repository metadata and checks the commit workflow.
 

package/templates/vitepress/start/what-is-repoctl.md

@@ -0,0 +1,18 @@
+---
+title: What is repoctl?
+description: repoctl is the official task-first CLI for initializing, diagnosing, and maintaining pnpm and Turborepo monorepos.
+---
+
+# What is repoctl?
+
+repoctl is a task-first CLI for teams that build and maintain pnpm or Turborepo monorepos. It turns repository conventions into repeatable commands for initialization, diagnosis, project creation, checks, reports, and releases.
+
+## Start with repoctl
+
+```bash
+pnpm add -D repoctl
+pnpm exec repo init
+pnpm exec repo doctor
+```
+
+Read the [installation guide](/start/install-repoctl) or [command reference](/reference/commands).

package/templates/vitepress/tasks/adopt-existing.md

@@ -8,7 +8,7 @@ Use this task when a workspace already has scripts, hooks, or configuration that
 
 - Run commands from the workspace root.
 - Commit or stash unrelated local changes.
-- Confirm that Node.js 22.12 or newer and pnpm are available.
+- Confirm that Node.js 22.13 or newer and pnpm are available.
 
 ## Smallest Command
 

package/templates/vitepress/tsconfig.json

@@ -4,6 +4,7 @@
     "module": "ESNext",
     "moduleResolution": "Bundler",
     "resolveJsonModule": true,
+    "allowImportingTsExtensions": true,
     "strict": true,
     "noEmit": true,
     "skipLibCheck": true