@farming-labs/docs 0.0.2-beta.3 → 0.0.2-beta.30

package/dist/cli/index.mjs

@@ -10,10 +10,14 @@ function detectFramework(cwd) {
 	const pkgPath = path.join(cwd, "package.json");
 	if (!fs.existsSync(pkgPath)) return null;
 	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-	if ({
+	const allDeps = {
 		...pkg.dependencies,
 		...pkg.devDependencies
-	}["next"]) return "nextjs";
+	};
+	if (allDeps["next"]) return "nextjs";
+	if (allDeps["@sveltejs/kit"]) return "sveltekit";
+	if (allDeps["astro"]) return "astro";
+	if (allDeps["nuxt"]) return "nuxt";
 	return null;
 }
 function detectPackageManager(cwd) {
@@ -53,16 +57,19 @@ function readFileSafe(filePath) {
 	if (!fs.existsSync(filePath)) return null;
 	return fs.readFileSync(filePath, "utf-8");
 }
-/** Common locations where global CSS files live in Next.js projects. */
+/** Common locations where global CSS files live in Next.js / SvelteKit projects. */
 const GLOBAL_CSS_CANDIDATES = [
 	"app/globals.css",
 	"app/global.css",
 	"src/app/globals.css",
 	"src/app/global.css",
+	"src/app.css",
 	"styles/globals.css",
 	"styles/global.css",
 	"src/styles/globals.css",
-	"src/styles/global.css"
+	"src/styles/global.css",
+	"assets/css/main.css",
+	"assets/main.css"
 ];
 /**
 * Find existing global CSS files in the project.
@@ -125,14 +132,132 @@ function spawnAndWaitFor(command, args, cwd, waitFor, timeoutMs = 6e4) {
 
 //#endregion
 //#region src/cli/templates.ts
+const THEME_INFO = {
+	fumadocs: {
+		factory: "fumadocs",
+		nextImport: "@farming-labs/theme",
+		svelteImport: "@farming-labs/svelte-theme",
+		astroImport: "@farming-labs/astro-theme",
+		nuxtImport: "@farming-labs/nuxt-theme",
+		nextCssImport: "default",
+		svelteCssTheme: "fumadocs",
+		astroCssTheme: "fumadocs",
+		nuxtCssTheme: "fumadocs"
+	},
+	darksharp: {
+		factory: "darksharp",
+		nextImport: "@farming-labs/theme/darksharp",
+		svelteImport: "@farming-labs/svelte-theme/darksharp",
+		astroImport: "@farming-labs/astro-theme/darksharp",
+		nuxtImport: "@farming-labs/nuxt-theme/darksharp",
+		nextCssImport: "darksharp",
+		svelteCssTheme: "darksharp",
+		astroCssTheme: "darksharp",
+		nuxtCssTheme: "darksharp"
+	},
+	"pixel-border": {
+		factory: "pixelBorder",
+		nextImport: "@farming-labs/theme/pixel-border",
+		svelteImport: "@farming-labs/svelte-theme/pixel-border",
+		astroImport: "@farming-labs/astro-theme/pixel-border",
+		nuxtImport: "@farming-labs/nuxt-theme/pixel-border",
+		nextCssImport: "pixel-border",
+		svelteCssTheme: "pixel-border",
+		astroCssTheme: "pixel-border",
+		nuxtCssTheme: "pixel-border"
+	},
+	colorful: {
+		factory: "colorful",
+		nextImport: "@farming-labs/theme/colorful",
+		svelteImport: "@farming-labs/svelte-theme/colorful",
+		astroImport: "@farming-labs/astro-theme/colorful",
+		nuxtImport: "@farming-labs/nuxt-theme/colorful",
+		nextCssImport: "colorful",
+		svelteCssTheme: "colorful",
+		astroCssTheme: "colorful",
+		nuxtCssTheme: "colorful"
+	},
+	darkbold: {
+		factory: "darkbold",
+		nextImport: "@farming-labs/theme/darkbold",
+		svelteImport: "@farming-labs/svelte-theme/darkbold",
+		astroImport: "@farming-labs/astro-theme/darkbold",
+		nuxtImport: "@farming-labs/nuxt-theme/darkbold",
+		nextCssImport: "darkbold",
+		svelteCssTheme: "darkbold",
+		astroCssTheme: "darkbold",
+		nuxtCssTheme: "darkbold"
+	},
+	shiny: {
+		factory: "shiny",
+		nextImport: "@farming-labs/theme/shiny",
+		svelteImport: "@farming-labs/svelte-theme/shiny",
+		astroImport: "@farming-labs/astro-theme/shiny",
+		nuxtImport: "@farming-labs/nuxt-theme/shiny",
+		nextCssImport: "shiny",
+		svelteCssTheme: "shiny",
+		astroCssTheme: "shiny",
+		nuxtCssTheme: "shiny"
+	},
+	greentree: {
+		factory: "greentree",
+		nextImport: "@farming-labs/theme/greentree",
+		svelteImport: "@farming-labs/svelte-theme/greentree",
+		astroImport: "@farming-labs/astro-theme/greentree",
+		nuxtImport: "@farming-labs/nuxt-theme/greentree",
+		nextCssImport: "greentree",
+		svelteCssTheme: "greentree",
+		astroCssTheme: "greentree",
+		nuxtCssTheme: "greentree"
+	}
+};
+function getThemeInfo(theme) {
+	return THEME_INFO[theme] ?? THEME_INFO.fumadocs;
+}
+/** Config import for Next.js app/layout.tsx → root docs.config */
+function nextRootLayoutConfigImport(useAlias) {
+	return useAlias ? "@/docs.config" : "../docs.config";
+}
+/** Config import for Next.js app/{entry}/layout.tsx → root docs.config */
+function nextDocsLayoutConfigImport(useAlias) {
+	return useAlias ? "@/docs.config" : "../../docs.config";
+}
+/** Config import for SvelteKit src/lib/docs.server.ts → src/lib/docs.config */
+function svelteServerConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config" : "./docs.config";
+}
+/** Config import for SvelteKit src/routes/{entry}/+layout.svelte → src/lib/docs.config */
+function svelteLayoutConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config" : "../../lib/docs.config";
+}
+/** Config import for SvelteKit src/routes/{entry}/[...slug]/+page.svelte → src/lib/docs.config */
+function sveltePageConfigImport(useAlias) {
+	return useAlias ? "$lib/docs.config" : "../../../lib/docs.config";
+}
+/** Server import for SvelteKit +layout.server.js → src/lib/docs.server */
+function svelteLayoutServerImport(useAlias) {
+	return useAlias ? "$lib/docs.server" : "../../lib/docs.server";
+}
+function astroServerConfigImport(useAlias) {
+	return useAlias ? "@/lib/docs.config" : "./docs.config";
+}
+function astroPageConfigImport(useAlias, depth) {
+	if (useAlias) return "@/lib/docs.config";
+	return `${"../".repeat(depth)}lib/docs.config`;
+}
+function astroPageServerImport(useAlias, depth) {
+	if (useAlias) return "@/lib/docs.server";
+	return `${"../".repeat(depth)}lib/docs.server`;
+}
 function docsConfigTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 import { defineDocs } from "@farming-labs/docs";
-import { fumadocs } from "@farming-labs/fumadocs";
+import { ${t.factory} } from "${t.nextImport}";
 
 export default defineDocs({
   entry: "${cfg.entry}",
-  theme: fumadocs({
+  theme: ${t.factory}({
     ui: {
       colors: { primary: "#6366f1" },
     },
@@ -169,15 +294,15 @@ function nextConfigMergedTemplate(existingContent) {
 	}
 	return lines.join("\n");
 }
-function rootLayoutTemplate(globalCssRelPath = "app/globals.css") {
+function rootLayoutTemplate(cfg, globalCssRelPath = "app/globals.css") {
 	let cssImport;
 	if (globalCssRelPath.startsWith("app/")) cssImport = "./" + globalCssRelPath.slice(4);
 	else if (globalCssRelPath.startsWith("src/app/")) cssImport = "./" + globalCssRelPath.slice(8);
 	else cssImport = "../" + globalCssRelPath;
 	return `\
 import type { Metadata } from "next";
-import { RootProvider } from "@farming-labs/fumadocs";
-import docsConfig from "@/docs.config";
+import { RootProvider } from "@farming-labs/theme";
+import docsConfig from "${nextRootLayoutConfigImport(cfg.useAlias)}";
 import "${cssImport}";
 
 export const metadata: Metadata = {
@@ -206,26 +331,23 @@ export default function RootLayout({
 function globalCssTemplate(theme) {
 	return `\
 @import "tailwindcss";
-@import "@farming-labs/${theme}/css";
+@import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";
 `;
 }
-/**
-* Inject the fumadocs CSS import into an existing global.css.
-* Returns the modified content, or null if already present.
-*/
 function injectCssImport(existingContent, theme) {
-	const importLine = `@import "@farming-labs/${theme}/css";`;
+	const importLine = `@import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";`;
 	if (existingContent.includes(importLine)) return null;
+	if (existingContent.includes("@farming-labs/theme/") && existingContent.includes("/css")) return null;
 	const lines = existingContent.split("\n");
 	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
 	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
 	else lines.unshift(importLine);
 	return lines.join("\n");
 }
-function docsLayoutTemplate() {
+function docsLayoutTemplate(cfg) {
 	return `\
-import docsConfig from "@/docs.config";
-import { createDocsLayout } from "@farming-labs/fumadocs";
+import docsConfig from "${nextDocsLayoutConfigImport(cfg.useAlias)}";
+import { createDocsLayout } from "@farming-labs/theme";
 
 export default createDocsLayout(docsConfig);
 `;
@@ -241,7 +363,8 @@ const config = {
 export default config;
 `;
 }
-function tsconfigTemplate() {
+/** @param useAlias - When false, paths (e.g. @/*) are omitted so no alias is added. */
+function tsconfigTemplate(useAlias = false) {
 	return `\
 {
   "compilerOptions": {
@@ -258,8 +381,7 @@ function tsconfigTemplate() {
     "isolatedModules": true,
     "jsx": "react-jsx",
     "incremental": true,
-    "plugins": [{ "name": "next" }],
-    "paths": { "@/*": ["./*"] }
+    "plugins": [{ "name": "next" }]${useAlias ? ",\n    \"paths\": { \"@/*\": [\"./*\"] }" : ""}
   },
   "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
   "exclude": ["node_modules"]
@@ -304,6 +426,7 @@ Start by reading the [Installation](/${cfg.entry}/installation) guide, then foll
 `;
 }
 function installationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 ---
 title: "Installation"
@@ -330,11 +453,11 @@ Your project includes a \`docs.config.ts\` at the root:
 
 \`\`\`ts
 import { defineDocs } from "@farming-labs/docs";
-import { fumadocs } from "@farming-labs/fumadocs";
+import { ${t.factory} } from "${t.nextImport}";
 
 export default defineDocs({
   entry: "${cfg.entry}",
-  theme: fumadocs({
+  theme: ${t.factory}({
     ui: { colors: { primary: "#6366f1" } },
   }),
 });
@@ -361,6 +484,7 @@ Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your f
 `;
 }
 function quickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
 	return `\
 ---
 title: "Quickstart"
@@ -423,7 +547,7 @@ console.log(greet("World"));
 Edit \`docs.config.ts\` to change colors, typography, and component defaults:
 
 \`\`\`ts
-theme: fumadocs({
+theme: ${t.factory}({
   ui: {
     colors: { primary: "#22c55e" },
   },
@@ -441,216 +565,1451 @@ pnpm build
 Deploy to Vercel, Netlify, or any Node.js hosting platform.
 `;
 }
+function svelteDocsConfigTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.svelteImport}";
 
-//#endregion
-//#region src/cli/init.ts
-async function init() {
-	const cwd = process.cwd();
-	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs ")));
-	if (!detectFramework(cwd)) {
-		p.log.error("Could not detect a supported framework.\n  Make sure you have a " + pc.cyan("package.json") + " with " + pc.cyan("next") + " installed.\n  Supported frameworks: Next.js");
-		p.outro(pc.red("Init cancelled."));
-		process.exit(1);
-	}
-	p.log.success(`Detected framework: ${pc.cyan("Next.js")}`);
-	const theme = await p.select({
-		message: "Which theme would you like to use?",
-		options: [{
-			value: "fumadocs",
-			label: "Fumadocs",
-			hint: "Clean, modern docs theme with sidebar, search, and dark mode"
-		}]
-	});
-	if (p.isCancel(theme)) {
-		p.outro(pc.red("Init cancelled."));
-		process.exit(0);
-	}
-	const entry = await p.text({
-		message: "Where should your docs live?",
-		placeholder: "docs",
-		defaultValue: "docs",
-		validate: (value) => {
-			if (!value) return "Entry path is required";
-			if (value.startsWith("/")) return "Use a relative path (no leading /)";
-			if (value.includes(" ")) return "Path cannot contain spaces";
-		}
-	});
-	if (p.isCancel(entry)) {
-		p.outro(pc.red("Init cancelled."));
-		process.exit(0);
-	}
-	const entryPath = entry;
-	const detectedCssFiles = detectGlobalCssFiles(cwd);
-	let globalCssRelPath;
-	if (detectedCssFiles.length === 1) {
-		globalCssRelPath = detectedCssFiles[0];
-		p.log.info(`Found global CSS at ${pc.cyan(globalCssRelPath)}`);
-	} else if (detectedCssFiles.length > 1) {
-		const picked = await p.select({
-			message: "Multiple global CSS files found. Which one should we use?",
-			options: detectedCssFiles.map((f) => ({
-				value: f,
-				label: f
-			}))
-		});
-		if (p.isCancel(picked)) {
-			p.outro(pc.red("Init cancelled."));
-			process.exit(0);
-		}
-		globalCssRelPath = picked;
-	} else {
-		const cssPath = await p.text({
-			message: "Where is your global CSS file?",
-			placeholder: "app/globals.css",
-			defaultValue: "app/globals.css",
-			validate: (value) => {
-				if (!value) return "CSS file path is required";
-				if (!value.endsWith(".css")) return "Path must end with .css";
-			}
-		});
-		if (p.isCancel(cssPath)) {
-			p.outro(pc.red("Init cancelled."));
-			process.exit(0);
-		}
-		globalCssRelPath = cssPath;
-	}
-	const pkgJson = JSON.parse(readFileSafe(path.join(cwd, "package.json")));
-	const cfg = {
-		entry: entryPath,
-		theme,
-		projectName: pkgJson.name || "My Project"
-	};
-	const s = p.spinner();
-	s.start("Scaffolding docs files");
-	const written = [];
-	const skipped = [];
-	function write(rel, content, overwrite = false) {
-		if (writeFileSafe(path.join(cwd, rel), content, overwrite)) written.push(rel);
-		else skipped.push(rel);
-	}
-	write("docs.config.ts", docsConfigTemplate(cfg));
-	const existingNextConfig = readFileSafe(path.join(cwd, "next.config.ts")) ?? readFileSafe(path.join(cwd, "next.config.mjs")) ?? readFileSafe(path.join(cwd, "next.config.js"));
-	if (existingNextConfig) {
-		const configFile = fileExists(path.join(cwd, "next.config.ts")) ? "next.config.ts" : fileExists(path.join(cwd, "next.config.mjs")) ? "next.config.mjs" : "next.config.js";
-		const merged = nextConfigMergedTemplate(existingNextConfig);
-		if (merged !== existingNextConfig) {
-			writeFileSafe(path.join(cwd, configFile), merged, true);
-			written.push(configFile + " (updated)");
-		} else skipped.push(configFile + " (already configured)");
-	} else write("next.config.ts", nextConfigTemplate());
-	write("app/layout.tsx", rootLayoutTemplate(globalCssRelPath));
-	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
-	const existingGlobalCss = readFileSafe(globalCssAbsPath);
-	if (existingGlobalCss) {
-		const injected = injectCssImport(existingGlobalCss, theme);
-		if (injected) {
-			writeFileSafe(globalCssAbsPath, injected, true);
-			written.push(globalCssRelPath + " (updated)");
-		} else skipped.push(globalCssRelPath + " (already configured)");
-	} else write(globalCssRelPath, globalCssTemplate(theme));
-	write(`app/${entryPath}/layout.tsx`, docsLayoutTemplate());
-	write("postcss.config.mjs", postcssConfigTemplate());
-	if (!fileExists(path.join(cwd, "tsconfig.json"))) write("tsconfig.json", tsconfigTemplate());
-	write(`app/${entryPath}/page.mdx`, welcomePageTemplate(cfg));
-	write(`app/${entryPath}/installation/page.mdx`, installationPageTemplate(cfg));
-	write(`app/${entryPath}/quickstart/page.mdx`, quickstartPageTemplate(cfg));
-	s.stop("Files scaffolded");
-	if (written.length > 0) p.log.success(`Created ${written.length} file${written.length > 1 ? "s" : ""}:\n` + written.map((f) => `  ${pc.green("+")} ${f}`).join("\n"));
-	if (skipped.length > 0) p.log.info(`Skipped ${skipped.length} existing file${skipped.length > 1 ? "s" : ""}:\n` + skipped.map((f) => `  ${pc.dim("-")} ${f}`).join("\n"));
-	const pm = detectPackageManager(cwd);
-	p.log.info(`Using ${pc.cyan(pm)} as package manager`);
-	const s2 = p.spinner();
-	s2.start("Installing dependencies");
-	try {
-		exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/next @farming-labs/fumadocs`, cwd);
-		const devDeps = [
-			"@tailwindcss/postcss",
-			"postcss",
-			"tailwindcss",
-			"@types/mdx",
-			"@types/node"
-		];
-		const allDeps = {
-			...pkgJson.dependencies,
-			...pkgJson.devDependencies
-		};
-		const missingDevDeps = devDeps.filter((d) => !allDeps[d]);
-		if (missingDevDeps.length > 0) exec(`${devInstallCommand(pm)} ${missingDevDeps.join(" ")}`, cwd);
-	} catch {
-		s2.stop("Failed to install dependencies");
-		p.log.error(`Dependency installation failed. Run the install command manually:
-  ${pc.cyan(`${installCommand(pm)} @farming-labs/docs`)}`);
-		p.outro(pc.yellow("Setup partially complete. Install deps and run dev server manually."));
-		process.exit(1);
-	}
-	s2.stop("Dependencies installed");
-	const startDev = await p.confirm({
-		message: "Start the dev server now?",
-		initialValue: true
-	});
-	if (p.isCancel(startDev) || !startDev) {
-		p.log.info(`You can start the dev server later with:
-  ${pc.cyan(`${pm === "yarn" ? "yarn" : pm + " run"} dev`)}`);
-		p.outro(pc.green("Done! Happy documenting."));
-		process.exit(0);
-	}
-	p.log.step("Starting dev server...");
-	try {
-		const child = await spawnAndWaitFor("npx", [
-			"next",
-			"dev",
-			"--webpack"
-		], cwd, "Ready", 6e4);
-		const url = `http://localhost:3000/${entryPath}`;
-		console.log();
-		p.log.success(`Dev server is running! Your docs are live at:\n\n  ${pc.cyan(pc.underline(url))}\n\n  Press ${pc.dim("Ctrl+C")} to stop the server.`);
-		p.outro(pc.green("Happy documenting!"));
-		await new Promise((resolve) => {
-			child.on("close", () => resolve());
-			process.on("SIGINT", () => {
-				child.kill("SIGINT");
-				resolve();
-			});
-			process.on("SIGTERM", () => {
-				child.kill("SIGTERM");
-				resolve();
-			});
-		});
-	} catch (err) {
-		p.log.error(`Could not start dev server. Try running manually:
-  ${pc.cyan("npx next dev --webpack")}`);
-		p.outro(pc.yellow("Setup complete. Start the server manually."));
-		process.exit(1);
-	}
+export default defineDocs({
+  entry: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+}
+function svelteDocsServerTemplate(cfg) {
+	return `\
+import { createDocsServer } from "@farming-labs/svelte/server";
+import config from "${svelteServerConfigImport(cfg.useAlias)}";
+
+// preload for production
+const contentFiles = import.meta.glob("/${cfg.entry ?? "docs"}/**/*.{md,mdx,svx}", {
+  query: "?raw",
+  import: "default",
+  eager: true,
+}) as Record<string, string>;
+
+export const { load, GET, POST } = createDocsServer({
+  ...config,
+  _preloadedContent: contentFiles,
+});
+`;
 }
+function svelteDocsLayoutTemplate(cfg) {
+	return `\
+<script>
+  import { DocsLayout } from "@farming-labs/svelte-theme";
+  import config from "${svelteLayoutConfigImport(cfg.useAlias)}";
 
-//#endregion
-//#region src/cli/index.ts
-const command = process.argv.slice(2)[0];
-async function main() {
-	if (!command || command === "init") await init();
-	else if (command === "--help" || command === "-h") printHelp();
-	else if (command === "--version" || command === "-v") printVersion();
-	else {
-		console.error(pc.red(`Unknown command: ${command}`));
-		console.error();
-		printHelp();
-		process.exit(1);
-	}
+  let { data, children } = $props();
+<\/script>
+
+<DocsLayout tree={data.tree} {config}>
+  {@render children()}
+</DocsLayout>
+`;
 }
-function printHelp() {
-	console.log(`
-${pc.bold("@farming-labs/docs")} — Documentation framework CLI
+function svelteDocsLayoutServerTemplate(cfg) {
+	return `\
+export { load } from "${svelteLayoutServerImport(cfg.useAlias)}";
+`;
+}
+function svelteDocsPageTemplate(cfg) {
+	return `\
+<script>
+  import { DocsContent } from "@farming-labs/svelte-theme";
+  import config from "${sveltePageConfigImport(cfg.useAlias)}";
 
-${pc.dim("Usage:")}
-  npx @farming-labs/docs ${pc.cyan("<command>")}
+  let { data } = $props();
+<\/script>
 
-${pc.dim("Commands:")}
-  ${pc.cyan("init")}    Scaffold docs in your project (default)
+<DocsContent {data} {config} />
+`;
+}
+function svelteRootLayoutTemplate(globalCssRelPath) {
+	let cssImport;
+	if (globalCssRelPath.startsWith("src/")) cssImport = "./" + globalCssRelPath.slice(4);
+	else cssImport = "../" + globalCssRelPath;
+	return `\
+<script>
+  import "${cssImport}";
+
+  let { children } = $props();
+<\/script>
+
+{@render children()}
+`;
+}
+function svelteGlobalCssTemplate(theme) {
+	return `\
+@import "@farming-labs/svelte-theme/${theme}/css";
+`;
+}
+function svelteCssImportLine(theme) {
+	return `@import "@farming-labs/svelte-theme/${theme}/css";`;
+}
+function injectSvelteCssImport(existingContent, theme) {
+	const importLine = svelteCssImportLine(theme);
+	if (existingContent.includes(importLine)) return null;
+	const lines = existingContent.split("\n");
+	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine);
+	return lines.join("\n");
+}
+function svelteWelcomePageTemplate(cfg) {
+	return `\
+---
+title: "Documentation"
+description: "Welcome to ${cfg.projectName} documentation"
+---
+
+# Welcome to ${cfg.projectName}
+
+Get started with our documentation. Browse the pages on the left to learn more.
+
+## Overview
+
+This documentation was generated by \`@farming-labs/docs\`. Edit the markdown files in \`${cfg.entry}/\` to customize.
+
+## Features
+
+- **Markdown Support** — Write docs with standard Markdown
+- **Syntax Highlighting** — Code blocks with automatic highlighting
+- **Dark Mode** — Built-in theme switching
+- **Search** — Full-text search across all pages
+- **Responsive** — Works on any screen size
+
+---
+
+## Next Steps
+
+Start by reading the [Installation](/${cfg.entry}/installation) guide, then follow the [Quickstart](/${cfg.entry}/quickstart) to build something.
+`;
+}
+function svelteInstallationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Installation"
+description: "How to install and set up ${cfg.projectName}"
+---
+
+# Installation
+
+Follow these steps to install and configure ${cfg.projectName}.
+
+## Prerequisites
+
+- Node.js 18+
+- A package manager (pnpm, npm, or yarn)
+
+## Install Dependencies
+
+\`\`\`bash
+pnpm add @farming-labs/docs @farming-labs/svelte @farming-labs/svelte-theme
+\`\`\`
+
+## Configuration
+
+Your project includes a \`docs.config.ts\` in \`src/lib/\`:
+
+\`\`\`ts title="src/lib/docs.config.ts"
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.svelteImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: { colors: { primary: "#6366f1" } },
+  }),
+});
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${cfg.entry}/                   # Markdown content
+  page.md                      # /${cfg.entry}
+  installation/
+    page.md                    # /${cfg.entry}/installation
+  quickstart/
+    page.md                    # /${cfg.entry}/quickstart
+src/
+  lib/
+    docs.config.ts             # Docs configuration
+    docs.server.ts             # Server-side docs loader
+  routes/
+    ${cfg.entry}/
+      +layout.svelte           # Docs layout
+      +layout.server.js        # Layout data loader
+      [...slug]/
+        +page.svelte           # Dynamic doc page
+\`\`\`
+
+## What's Next?
+
+Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your first page.
+`;
+}
+function svelteQuickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Quickstart"
+description: "Get up and running in minutes"
+---
+
+# Quickstart
+
+This guide walks you through creating your first documentation page.
+
+## Creating a Page
+
+Create a new folder under \`${cfg.entry}/\` with a \`page.md\` file:
+
+\`\`\`bash
+mkdir -p ${cfg.entry}/my-page
+\`\`\`
+
+Then create \`${cfg.entry}/my-page/page.md\`:
+
+\`\`\`md
+---
+title: "My Page"
+description: "A custom documentation page"
+---
+
+# My Page
+
+Write your content here using **Markdown**.
+\`\`\`
+
+Your page is now available at \`/${cfg.entry}/my-page\`.
+
+## Code Blocks
+
+Code blocks are automatically syntax-highlighted:
+
+\`\`\`typescript
+function greet(name: string): string {
+  return \\\`Hello, \\\${name}!\\\`;
+}
+
+console.log(greet("World"));
+\`\`\`
+
+## Customizing the Theme
+
+Edit \`src/lib/docs.config.ts\` to change colors, typography, and component defaults:
+
+\`\`\`ts title="src/lib/docs.config.ts"
+theme: ${t.factory}({
+  ui: {
+    colors: { primary: "#22c55e" },
+  },
+}),
+\`\`\`
+
+## Deploying
+
+Build your docs for production:
+
+\`\`\`bash
+pnpm build
+\`\`\`
+
+Deploy to Vercel, Netlify, or any Node.js hosting platform.
+`;
+}
+function astroDocsConfigTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.astroImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+}
+function astroDocsServerTemplate(cfg) {
+	return `\
+import { createDocsServer } from "@farming-labs/astro/server";
+import config from "${astroServerConfigImport(cfg.useAlias)}";
+
+const contentFiles = import.meta.glob("/${cfg.entry ?? "docs"}/**/*.{md,mdx}", {
+  query: "?raw",
+  import: "default",
+  eager: true,
+}) as Record<string, string>;
+
+export const { load, GET, POST } = createDocsServer({
+  ...config,
+  _preloadedContent: contentFiles,
+});
+`;
+}
+const ASTRO_ADAPTER_INFO = {
+	vercel: {
+		pkg: "@astrojs/vercel",
+		import: "@astrojs/vercel"
+	},
+	netlify: {
+		pkg: "@astrojs/netlify",
+		import: "@astrojs/netlify"
+	},
+	node: {
+		pkg: "@astrojs/node",
+		import: "@astrojs/node"
+	},
+	cloudflare: {
+		pkg: "@astrojs/cloudflare",
+		import: "@astrojs/cloudflare"
+	}
+};
+function getAstroAdapterPkg(adapter) {
+	return ASTRO_ADAPTER_INFO[adapter]?.pkg ?? ASTRO_ADAPTER_INFO.vercel.pkg;
+}
+function astroConfigTemplate(adapter = "vercel") {
+	const info = ASTRO_ADAPTER_INFO[adapter] ?? ASTRO_ADAPTER_INFO.vercel;
+	const adapterCall = adapter === "node" ? `${adapter}({ mode: "standalone" })` : `${adapter}()`;
+	return `\
+import { defineConfig } from "astro/config";
+import ${adapter} from "${info.import}";
+
+export default defineConfig({
+  output: "server",
+  adapter: ${adapterCall},
+});
+`;
+}
+function astroDocsPageTemplate(cfg) {
+	return `\
+---
+import DocsLayout from "@farming-labs/astro-theme/src/components/DocsLayout.astro";
+import DocsContent from "@farming-labs/astro-theme/src/components/DocsContent.astro";
+import SearchDialog from "@farming-labs/astro-theme/src/components/SearchDialog.astro";
+import config from "${astroPageConfigImport(cfg.useAlias, 2)}";
+import { load } from "${astroPageServerImport(cfg.useAlias, 2)}";
+import "${`@farming-labs/astro-theme/${getThemeInfo(cfg.theme).astroCssTheme}/css`}";
+
+const data = await load(Astro.url.pathname);
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{data.title} – Docs</title>
+  </head>
+  <body>
+    <DocsLayout tree={data.tree} config={config}>
+      <DocsContent data={data} config={config} />
+    </DocsLayout>
+    <SearchDialog config={config} />
+  </body>
+</html>
+`;
+}
+function astroDocsIndexTemplate(cfg) {
+	return `\
+---
+import DocsLayout from "@farming-labs/astro-theme/src/components/DocsLayout.astro";
+import DocsContent from "@farming-labs/astro-theme/src/components/DocsContent.astro";
+import SearchDialog from "@farming-labs/astro-theme/src/components/SearchDialog.astro";
+import config from "${astroPageConfigImport(cfg.useAlias, 2)}";
+import { load } from "${astroPageServerImport(cfg.useAlias, 2)}";
+import "${`@farming-labs/astro-theme/${getThemeInfo(cfg.theme).astroCssTheme}/css`}";
+
+const data = await load(Astro.url.pathname);
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{data.title} – Docs</title>
+  </head>
+  <body>
+    <DocsLayout tree={data.tree} config={config}>
+      <DocsContent data={data} config={config} />
+    </DocsLayout>
+    <SearchDialog config={config} />
+  </body>
+</html>
+`;
+}
+function astroApiRouteTemplate(cfg) {
+	return `\
+import type { APIRoute } from "astro";
+import { GET as docsGET, POST as docsPOST } from "${astroPageServerImport(cfg.useAlias, 2)}";
+
+export const GET: APIRoute = async ({ request }) => {
+  return docsGET({ request });
+};
+
+export const POST: APIRoute = async ({ request }) => {
+  return docsPOST({ request });
+};
+`;
+}
+function astroGlobalCssTemplate(theme) {
+	return `\
+@import "@farming-labs/astro-theme/${theme}/css";
+`;
+}
+function astroCssImportLine(theme) {
+	return `@import "@farming-labs/astro-theme/${theme}/css";`;
+}
+function injectAstroCssImport(existingContent, theme) {
+	const importLine = astroCssImportLine(theme);
+	if (existingContent.includes(importLine)) return null;
+	const lines = existingContent.split("\n");
+	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine);
+	return lines.join("\n");
+}
+function astroWelcomePageTemplate(cfg) {
+	return `\
+---
+title: "Documentation"
+description: "Welcome to ${cfg.projectName} documentation"
+---
+
+# Welcome to ${cfg.projectName}
+
+Get started with our documentation. Browse the pages on the left to learn more.
+
+## Overview
+
+This documentation was generated by \`@farming-labs/docs\`. Edit the markdown files in \`${cfg.entry}/\` to customize.
+
+## Features
+
+- **Markdown Support** — Write docs with standard Markdown
+- **Syntax Highlighting** — Code blocks with automatic highlighting
+- **Dark Mode** — Built-in theme switching
+- **Search** — Full-text search across all pages
+- **Responsive** — Works on any screen size
+
+---
+
+## Next Steps
+
+Start by reading the [Installation](/${cfg.entry}/installation) guide, then follow the [Quickstart](/${cfg.entry}/quickstart) to build something.
+`;
+}
+function astroInstallationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Installation"
+description: "How to install and set up ${cfg.projectName}"
+---
+
+# Installation
+
+Follow these steps to install and configure ${cfg.projectName}.
+
+## Prerequisites
+
+- Node.js 18+
+- A package manager (pnpm, npm, or yarn)
+
+## Install Dependencies
+
+\\\`\\\`\\\`bash
+pnpm add @farming-labs/docs @farming-labs/astro @farming-labs/astro-theme
+\\\`\\\`\\\`
+
+## Configuration
+
+Your project includes a \\\`docs.config.ts\\\` in \\\`src/lib/\\\`:
+
+\\\`\\\`\\\`ts title="src/lib/docs.config.ts"
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.astroImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: { colors: { primary: "#6366f1" } },
+  }),
+});
+\\\`\\\`\\\`
+
+## Project Structure
+
+\\\`\\\`\\\`
+${cfg.entry}/                   # Markdown content
+  page.md                      # /${cfg.entry}
+  installation/
+    page.md                    # /${cfg.entry}/installation
+  quickstart/
+    page.md                    # /${cfg.entry}/quickstart
+src/
+  lib/
+    docs.config.ts             # Docs configuration
+    docs.server.ts             # Server-side docs loader
+  pages/
+    ${cfg.entry}/
+      index.astro              # Docs index page
+      [...slug].astro          # Dynamic doc page
+    api/
+      ${cfg.entry}.ts          # Search/AI API route
+\\\`\\\`\\\`
+
+## What's Next?
+
+Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your first page.
+`;
+}
+function astroQuickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+title: "Quickstart"
+description: "Get up and running in minutes"
+---
+
+# Quickstart
+
+This guide walks you through creating your first documentation page.
+
+## Creating a Page
+
+Create a new folder under \\\`${cfg.entry}/\\\` with a \\\`page.md\\\` file:
+
+\\\`\\\`\\\`bash
+mkdir -p ${cfg.entry}/my-page
+\\\`\\\`\\\`
+
+Then create \\\`${cfg.entry}/my-page/page.md\\\`:
+
+\\\`\\\`\\\`md
+---
+title: "My Page"
+description: "A custom documentation page"
+---
+
+# My Page
+
+Write your content here using **Markdown**.
+\\\`\\\`\\\`
+
+Your page is now available at \\\`/${cfg.entry}/my-page\\\`.
+
+## Customizing the Theme
+
+Edit \\\`src/lib/docs.config.ts\\\` to change colors, typography, and component defaults:
+
+\\\`\\\`\\\`ts title="src/lib/docs.config.ts"
+theme: ${t.factory}({
+  ui: {
+    colors: { primary: "#22c55e" },
+  },
+}),
+\\\`\\\`\\\`
+
+## Deploying
+
+Build your docs for production:
+
+\\\`\\\`\\\`bash
+pnpm build
+\\\`\\\`\\\`
+
+Deploy to Vercel, Netlify, or any Node.js hosting platform.
+`;
+}
+function nuxtDocsConfigTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.nuxtImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+}
+function nuxtDocsServerTemplate(cfg) {
+	const contentDirName = cfg.entry ?? "docs";
+	return `\
+import { createDocsServer } from "@farming-labs/nuxt/server";
+import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
+
+const contentFiles = import.meta.glob("/${contentDirName}/**/*.{md,mdx}", {
+  query: "?raw",
+  import: "default",
+  eager: true,
+}) as Record<string, string>;
+
+export const docsServer = createDocsServer({
+  ...config,
+  _preloadedContent: contentFiles,
+});
+`;
+}
+function nuxtServerApiDocsGetTemplate() {
+	return `\
+import { getRequestURL } from "h3";
+import { docsServer } from "../utils/docs-server";
+
+export default defineEventHandler((event) => {
+  const url = getRequestURL(event);
+  const request = new Request(url.href, {
+    method: event.method,
+    headers: event.headers,
+  });
+  return docsServer.GET({ request });
+});
+`;
+}
+function nuxtServerApiDocsPostTemplate() {
+	return `\
+import { getRequestURL, readRawBody } from "h3";
+import { docsServer } from "../utils/docs-server";
+
+export default defineEventHandler(async (event) => {
+  const url = getRequestURL(event);
+  const body = await readRawBody(event);
+  const request = new Request(url.href, {
+    method: "POST",
+    headers: event.headers,
+    body: body ?? undefined,
+  });
+  return docsServer.POST({ request });
+});
+`;
+}
+function nuxtServerApiDocsLoadTemplate() {
+	return `\
+import { getQuery } from "h3";
+import { docsServer } from "../../utils/docs-server";
+
+export default defineEventHandler(async (event) => {
+  const query = getQuery(event);
+  const pathname = (query.pathname as string) ?? "/docs";
+  return docsServer.load(pathname);
+});
+`;
+}
+function nuxtDocsPageTemplate(cfg) {
+	return `\
+<script setup lang="ts">
+import { DocsLayout, DocsContent } from "@farming-labs/nuxt-theme";
+import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
+
+const route = useRoute();
+const pathname = computed(() => route.path);
+
+const { data, error } = await useAsyncData(\`docs-\${pathname.value}\`, () =>
+  $fetch("/api/docs/load", {
+    query: { pathname: pathname.value },
+  })
+);
+
+if (error.value) {
+  throw createError({
+    statusCode: 404,
+    statusMessage: "Page not found",
+  });
+}
+<\/script>
+
+<template>
+  <div v-if="data" class="fd-docs-wrapper">
+    <DocsLayout :tree="data.tree" :config="config">
+      <DocsContent :data="data" :config="config" />
+    </DocsLayout>
+  </div>
+</template>
+`;
+}
+function nuxtConfigTemplate(cfg) {
+	return `\
+export default defineNuxtConfig({
+  compatibilityDate: "2024-11-01",
+
+  css: ["@farming-labs/nuxt-theme/${getThemeInfo(cfg.theme).nuxtCssTheme}/css"],
+
+  vite: {
+    optimizeDeps: {
+      include: ["@farming-labs/docs", "@farming-labs/nuxt", "@farming-labs/nuxt-theme"],
+    },
+  },
+
+  nitro: {
+    moduleSideEffects: ["@farming-labs/nuxt/server"],
+  },
+});
+`;
+}
+function nuxtWelcomePageTemplate(cfg) {
+	return `\
+---
+order: 1
+title: Documentation
+description: Welcome to ${cfg.projectName} documentation
+icon: book
+---
+
+# Welcome to ${cfg.projectName}
+
+Get started with our documentation. Browse the pages on the left to learn more.
+
+## Overview
+
+This documentation was generated by \`@farming-labs/docs\`. Edit the markdown files in \`${cfg.entry}/\` to customize.
+
+## Features
+
+- **Markdown Support** — Write docs with standard Markdown
+- **Syntax Highlighting** — Code blocks with automatic highlighting
+- **Dark Mode** — Built-in theme switching
+- **Search** — Full-text search across all pages (⌘K)
+- **Responsive** — Works on any screen size
+
+---
+
+## Next Steps
+
+Start by reading the [Installation](/${cfg.entry}/installation) guide, then follow the [Quickstart](/${cfg.entry}/quickstart) to build something.
+`;
+}
+function nuxtInstallationPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+order: 3
+title: Installation
+description: How to install and set up ${cfg.projectName}
+icon: terminal
+---
+
+# Installation
+
+Follow these steps to install and configure ${cfg.projectName}.
+
+## Prerequisites
+
+- Node.js 18+
+- A package manager (pnpm, npm, or yarn)
+
+## Install Dependencies
+
+\`\`\`bash
+pnpm add @farming-labs/docs @farming-labs/nuxt @farming-labs/nuxt-theme
+\`\`\`
+
+## Configuration
+
+Your project includes a \`docs.config.ts\` at the root:
+
+\`\`\`ts title="docs.config.ts"
+import { defineDocs } from "@farming-labs/docs";
+import { ${t.factory} } from "${t.nuxtImport}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${t.factory}({
+    ui: { colors: { primary: "#6366f1" } },
+  }),
+});
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+${cfg.entry}/                   # Markdown content
+  page.md
+  installation/page.md
+  quickstart/page.md
+server/
+  utils/docs-server.ts          # createDocsServer + preloaded content
+  api/docs/
+    load.get.ts                 # Page data API
+    docs.get.ts                 # Search API
+    docs.post.ts                # AI chat API
+pages/
+  ${cfg.entry}/[[...slug]].vue   # Docs catch-all page
+docs.config.ts
+nuxt.config.ts
+\`\`\`
+
+## What's Next?
+
+Head to the [Quickstart](/${cfg.entry}/quickstart) guide to start writing your first page.
+`;
+}
+function nuxtQuickstartPageTemplate(cfg) {
+	const t = getThemeInfo(cfg.theme);
+	return `\
+---
+order: 2
+title: Quickstart
+description: Get up and running in minutes
+icon: rocket
+---
+
+# Quickstart
+
+This guide walks you through creating your first documentation page.
+
+## Creating a Page
+
+Create a new folder under \`${cfg.entry}/\` with a \`page.md\` file:
+
+\`\`\`bash
+mkdir -p ${cfg.entry}/my-page
+\`\`\`
+
+Then create \`${cfg.entry}/my-page/page.md\`:
+
+\`\`\`md
+---
+title: "My Page"
+description: "A custom documentation page"
+---
+
+# My Page
+
+Write your content here using **Markdown**.
+\`\`\`
+
+Your page is now available at \`/${cfg.entry}/my-page\`.
+
+## Customizing the Theme
+
+Edit \`docs.config.ts\` to change colors and typography:
+
+\`\`\`ts
+theme: ${t.factory}({
+  ui: {
+    colors: { primary: "#22c55e" },
+  },
+}),
+\`\`\`
+
+## Deploying
+
+Build your docs for production:
+
+\`\`\`bash
+pnpm build
+\`\`\`
+
+Deploy to Vercel, Netlify, or any Node.js hosting platform.
+`;
+}
+function nuxtGlobalCssTemplate(theme) {
+	return `\
+@import "@farming-labs/nuxt-theme/${theme}/css";
+`;
+}
+function nuxtCssImportLine(theme) {
+	return `@import "@farming-labs/nuxt-theme/${theme}/css";`;
+}
+function injectNuxtCssImport(existingContent, theme) {
+	const importLine = nuxtCssImportLine(theme);
+	if (existingContent.includes(importLine)) return null;
+	const lines = existingContent.split("\n");
+	const lastImportIdx = lines.reduce((acc, l, i) => l.trimStart().startsWith("@import") ? i : acc, -1);
+	if (lastImportIdx >= 0) lines.splice(lastImportIdx + 1, 0, importLine);
+	else lines.unshift(importLine);
+	return lines.join("\n");
+}
+
+//#endregion
+//#region src/cli/init.ts
+const EXAMPLES_REPO = "farming-labs/docs";
+const VALID_TEMPLATES = [
+	"next",
+	"nuxt",
+	"sveltekit",
+	"astro"
+];
+async function init(options = {}) {
+	const cwd = process.cwd();
+	p.intro(pc.bgCyan(pc.black(" @farming-labs/docs ")));
+	if (options.template) {
+		const template = options.template.toLowerCase();
+		if (!VALID_TEMPLATES.includes(template)) {
+			p.log.error(`Invalid ${pc.cyan("--template")}. Use one of: ${VALID_TEMPLATES.map((t) => pc.cyan(t)).join(", ")}`);
+			process.exit(1);
+		}
+		let projectName = options.name?.trim();
+		if (!projectName) {
+			const nameAnswer = await p.text({
+				message: "Project name? (we'll create this folder and bootstrap the app here)",
+				placeholder: "my-docs",
+				defaultValue: "my-docs",
+				validate: (value) => {
+					const v = (value ?? "").trim();
+					if (!v) return "Project name is required";
+					if (v.includes("/") || v.includes("\\")) return "Project name cannot contain path separators";
+					if (v.includes(" ")) return "Project name cannot contain spaces";
+				}
+			});
+			if (p.isCancel(nameAnswer)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			projectName = nameAnswer.trim();
+		}
+		const templateLabel = template === "next" ? "Next.js" : template === "nuxt" ? "Nuxt" : template === "sveltekit" ? "SvelteKit" : "Astro";
+		const targetDir = path.join(cwd, projectName);
+		const fs = await import("node:fs");
+		if (fs.existsSync(targetDir)) {
+			p.log.error(`Directory ${pc.cyan(projectName)} already exists. Choose a different ${pc.cyan("--name")} or remove it.`);
+			process.exit(1);
+		}
+		fs.mkdirSync(targetDir, { recursive: true });
+		p.log.step(`Bootstrapping project with ${pc.cyan(`'${projectName}'`)} (${templateLabel})...`);
+		try {
+			exec(`npx degit ${EXAMPLES_REPO}/examples/${template} . --force`, targetDir);
+		} catch (err) {
+			p.log.error("Failed to bootstrap. Check your connection and that the repo exists.");
+			process.exit(1);
+		}
+		p.log.success(`Bootstrapped ${pc.cyan(`'${projectName}'`)}. Installing dependencies...`);
+		const pm = detectPackageManager(targetDir);
+		try {
+			if (pm === "pnpm") exec("pnpm install", targetDir);
+			else if (pm === "yarn") exec("yarn install", targetDir);
+			else if (pm === "bun") exec("bun install", targetDir);
+			else exec("npm install", targetDir);
+		} catch {
+			p.log.warn("Dependency install failed. Run your package manager install command manually.");
+		}
+		const devCmd = pm === "yarn" ? "yarn dev" : pm === "bun" ? "bun dev" : `${pm} run dev`;
+		p.outro(pc.green(`Done! Run ${pc.cyan(`cd ${projectName} && ${devCmd}`)} to start the dev server.`));
+		process.exit(0);
+	}
+	let framework = detectFramework(cwd);
+	if (framework) {
+		const frameworkName = framework === "nextjs" ? "Next.js" : framework === "sveltekit" ? "SvelteKit" : framework === "astro" ? "Astro" : "Nuxt";
+		p.log.success(`Detected framework: ${pc.cyan(frameworkName)}`);
+	} else {
+		p.log.warn("Could not auto-detect a framework from " + pc.cyan("package.json") + ".");
+		const picked = await p.select({
+			message: "Which framework are you using?",
+			options: [
+				{
+					value: "nextjs",
+					label: "Next.js",
+					hint: "React framework with App Router"
+				},
+				{
+					value: "sveltekit",
+					label: "SvelteKit",
+					hint: "Svelte framework with file-based routing"
+				},
+				{
+					value: "astro",
+					label: "Astro",
+					hint: "Content-focused framework with island architecture"
+				},
+				{
+					value: "nuxt",
+					label: "Nuxt",
+					hint: "Vue 3 framework with file-based routing and Nitro server"
+				}
+			]
+		});
+		if (p.isCancel(picked)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		framework = picked;
+	}
+	const theme = await p.select({
+		message: "Which theme would you like to use?",
+		options: [
+			{
+				value: "fumadocs",
+				label: "Fumadocs (Default)",
+				hint: "Clean, modern docs theme with sidebar, search, and dark mode"
+			},
+			{
+				value: "darksharp",
+				label: "Darksharp",
+				hint: "All-black, sharp edges, zero-radius look"
+			},
+			{
+				value: "pixel-border",
+				label: "Pixel Border",
+				hint: "Rounded borders, pixel-perfect spacing, refined sidebar"
+			},
+			{
+				value: "colorful",
+				label: "Colorful",
+				hint: "Fumadocs-style neutral theme with description support"
+			},
+			{
+				value: "darkbold",
+				label: "DarkBold",
+				hint: "Pure monochrome, Geist typography, clean minimalism"
+			},
+			{
+				value: "shiny",
+				label: "Shiny",
+				hint: "Glossy, modern look with subtle shimmer effects"
+			},
+			{
+				value: "greentree",
+				label: "GreenTree",
+				hint: "Emerald green accent, Inter font, Mintlify-inspired"
+			}
+		]
+	});
+	if (p.isCancel(theme)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
+	const aliasHint = framework === "nextjs" ? `Uses ${pc.cyan("@/")} prefix (requires tsconfig paths)` : framework === "sveltekit" ? `Uses ${pc.cyan("$lib/")} prefix (SvelteKit built-in)` : framework === "nuxt" ? `Uses ${pc.cyan("~/")} prefix (Nuxt built-in)` : `Uses ${pc.cyan("@/")} prefix (requires tsconfig paths)`;
+	const useAlias = await p.confirm({
+		message: `Use path aliases for imports? ${pc.dim(aliasHint)}`,
+		initialValue: false
+	});
+	if (p.isCancel(useAlias)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
+	let astroAdapter;
+	if (framework === "astro") {
+		const adapter = await p.select({
+			message: "Where will you deploy?",
+			options: [
+				{
+					value: "vercel",
+					label: "Vercel",
+					hint: "Recommended for most projects"
+				},
+				{
+					value: "netlify",
+					label: "Netlify"
+				},
+				{
+					value: "cloudflare",
+					label: "Cloudflare Pages"
+				},
+				{
+					value: "node",
+					label: "Node.js / Docker",
+					hint: "Self-hosted standalone server"
+				}
+			]
+		});
+		if (p.isCancel(adapter)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		astroAdapter = adapter;
+	}
+	const entry = await p.text({
+		message: "Where should your docs live?",
+		placeholder: "docs",
+		defaultValue: "docs",
+		validate: (value) => {
+			if (!value) return "Entry path is required";
+			if (value.startsWith("/")) return "Use a relative path (no leading /)";
+			if (value.includes(" ")) return "Path cannot contain spaces";
+		}
+	});
+	if (p.isCancel(entry)) {
+		p.outro(pc.red("Init cancelled."));
+		process.exit(0);
+	}
+	const entryPath = entry;
+	const detectedCssFiles = detectGlobalCssFiles(cwd);
+	let globalCssRelPath;
+	const defaultCssPath = framework === "sveltekit" ? "src/app.css" : framework === "astro" ? "src/styles/global.css" : framework === "nuxt" ? "assets/css/main.css" : "app/globals.css";
+	if (detectedCssFiles.length === 1) {
+		globalCssRelPath = detectedCssFiles[0];
+		p.log.info(`Found global CSS at ${pc.cyan(globalCssRelPath)}`);
+	} else if (detectedCssFiles.length > 1) {
+		const picked = await p.select({
+			message: "Multiple global CSS files found. Which one should we use?",
+			options: detectedCssFiles.map((f) => ({
+				value: f,
+				label: f
+			}))
+		});
+		if (p.isCancel(picked)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		globalCssRelPath = picked;
+	} else {
+		const cssPath = await p.text({
+			message: "Where is your global CSS file?",
+			placeholder: defaultCssPath,
+			defaultValue: defaultCssPath,
+			validate: (value) => {
+				if (!value) return "CSS file path is required";
+				if (!value.endsWith(".css")) return "Path must end with .css";
+			}
+		});
+		if (p.isCancel(cssPath)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		globalCssRelPath = cssPath;
+	}
+	const pkgJsonContent = readFileSafe(path.join(cwd, "package.json"));
+	const pkgJson = pkgJsonContent ? JSON.parse(pkgJsonContent) : { name: "my-project" };
+	const cfg = {
+		entry: entryPath,
+		theme,
+		projectName: pkgJson.name || "My Project",
+		framework,
+		useAlias,
+		astroAdapter
+	};
+	const s = p.spinner();
+	s.start("Scaffolding docs files");
+	const written = [];
+	const skipped = [];
+	function write(rel, content, overwrite = false) {
+		if (writeFileSafe(path.join(cwd, rel), content, overwrite)) written.push(rel);
+		else skipped.push(rel);
+	}
+	if (framework === "sveltekit") scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written);
+	else if (framework === "astro") scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written);
+	else if (framework === "nuxt") scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written);
+	else scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written);
+	s.stop("Files scaffolded");
+	if (written.length > 0) p.log.success(`Created ${written.length} file${written.length > 1 ? "s" : ""}:\n` + written.map((f) => `  ${pc.green("+")} ${f}`).join("\n"));
+	if (skipped.length > 0) p.log.info(`Skipped ${skipped.length} existing file${skipped.length > 1 ? "s" : ""}:\n` + skipped.map((f) => `  ${pc.dim("-")} ${f}`).join("\n"));
+	const pm = detectPackageManager(cwd);
+	p.log.info(`Using ${pc.cyan(pm)} as package manager`);
+	const s2 = p.spinner();
+	s2.start("Installing dependencies");
+	try {
+		if (framework === "sveltekit") exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/svelte @farming-labs/svelte-theme`, cwd);
+		else if (framework === "astro") {
+			const adapterPkg = getAstroAdapterPkg(cfg.astroAdapter ?? "vercel");
+			exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/astro @farming-labs/astro-theme ${adapterPkg}`, cwd);
+		} else if (framework === "nuxt") exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/nuxt @farming-labs/nuxt-theme`, cwd);
+		else {
+			exec(`${installCommand(pm)} @farming-labs/docs @farming-labs/next @farming-labs/theme`, cwd);
+			const devDeps = [
+				"@tailwindcss/postcss",
+				"postcss",
+				"tailwindcss",
+				"@types/mdx",
+				"@types/node"
+			];
+			const allDeps = {
+				...pkgJson.dependencies,
+				...pkgJson.devDependencies
+			};
+			const missingDevDeps = devDeps.filter((d) => !allDeps[d]);
+			if (missingDevDeps.length > 0) exec(`${devInstallCommand(pm)} ${missingDevDeps.join(" ")}`, cwd);
+		}
+	} catch {
+		s2.stop("Failed to install dependencies");
+		p.log.error(`Dependency installation failed. Run the install command manually:
+  ${pc.cyan(`${installCommand(pm)} @farming-labs/docs`)}`);
+		p.outro(pc.yellow("Setup partially complete. Install deps and run dev server manually."));
+		process.exit(1);
+	}
+	s2.stop("Dependencies installed");
+	const startDev = await p.confirm({
+		message: "Start the dev server now?",
+		initialValue: true
+	});
+	if (p.isCancel(startDev) || !startDev) {
+		p.log.info(`You can start the dev server later with:
+  ${pc.cyan(`${pm === "yarn" ? "yarn" : pm + " run"} dev`)}`);
+		p.outro(pc.green("Done! Happy documenting."));
+		process.exit(0);
+	}
+	p.log.step("Starting dev server...");
+	const devCommand = framework === "sveltekit" ? {
+		cmd: "npx",
+		args: ["vite", "dev"],
+		waitFor: "ready"
+	} : framework === "astro" ? {
+		cmd: "npx",
+		args: ["astro", "dev"],
+		waitFor: "ready"
+	} : framework === "nuxt" ? {
+		cmd: "npx",
+		args: ["nuxt", "dev"],
+		waitFor: "Local"
+	} : {
+		cmd: "npx",
+		args: [
+			"next",
+			"dev",
+			"--webpack"
+		],
+		waitFor: "Ready"
+	};
+	const defaultPort = framework === "sveltekit" ? "5173" : framework === "astro" ? "4321" : framework === "nuxt" ? "3000" : "3000";
+	try {
+		const child = await spawnAndWaitFor(devCommand.cmd, devCommand.args, cwd, devCommand.waitFor, 6e4);
+		const url = `http://localhost:${defaultPort}/${entryPath}`;
+		console.log();
+		p.log.success(`Dev server is running! Your docs are live at:\n\n  ${pc.cyan(pc.underline(url))}\n\n  Press ${pc.dim("Ctrl+C")} to stop the server.`);
+		p.outro(pc.green("Happy documenting!"));
+		await new Promise((resolve) => {
+			child.on("close", () => resolve());
+			process.on("SIGINT", () => {
+				child.kill("SIGINT");
+				resolve();
+			});
+			process.on("SIGTERM", () => {
+				child.kill("SIGTERM");
+				resolve();
+			});
+		});
+	} catch (err) {
+		const manualCmd = framework === "sveltekit" ? "npx vite dev" : framework === "astro" ? "npx astro dev" : framework === "nuxt" ? "npx nuxt dev" : "npx next dev --webpack";
+		p.log.error(`Could not start dev server. Try running manually:
+  ${pc.cyan(manualCmd)}`);
+		p.outro(pc.yellow("Setup complete. Start the server manually."));
+		process.exit(1);
+	}
+}
+function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	write("docs.config.ts", docsConfigTemplate(cfg));
+	const existingNextConfig = readFileSafe(path.join(cwd, "next.config.ts")) ?? readFileSafe(path.join(cwd, "next.config.mjs")) ?? readFileSafe(path.join(cwd, "next.config.js"));
+	if (existingNextConfig) {
+		const configFile = fileExists(path.join(cwd, "next.config.ts")) ? "next.config.ts" : fileExists(path.join(cwd, "next.config.mjs")) ? "next.config.mjs" : "next.config.js";
+		const merged = nextConfigMergedTemplate(existingNextConfig);
+		if (merged !== existingNextConfig) {
+			writeFileSafe(path.join(cwd, configFile), merged, true);
+			written.push(configFile + " (updated)");
+		} else skipped.push(configFile + " (already configured)");
+	} else write("next.config.ts", nextConfigTemplate());
+	write("app/layout.tsx", rootLayoutTemplate(cfg, globalCssRelPath));
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	if (existingGlobalCss) {
+		const injected = injectCssImport(existingGlobalCss, cfg.theme);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, globalCssTemplate(cfg.theme));
+	write(`app/${cfg.entry}/layout.tsx`, docsLayoutTemplate(cfg));
+	write("postcss.config.mjs", postcssConfigTemplate());
+	if (!fileExists(path.join(cwd, "tsconfig.json"))) write("tsconfig.json", tsconfigTemplate(cfg.useAlias));
+	write(`app/${cfg.entry}/page.mdx`, welcomePageTemplate(cfg));
+	write(`app/${cfg.entry}/installation/page.mdx`, installationPageTemplate(cfg));
+	write(`app/${cfg.entry}/quickstart/page.mdx`, quickstartPageTemplate(cfg));
+}
+function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	write("src/lib/docs.config.ts", svelteDocsConfigTemplate(cfg));
+	write("src/lib/docs.server.ts", svelteDocsServerTemplate(cfg));
+	write(`src/routes/${cfg.entry}/+layout.svelte`, svelteDocsLayoutTemplate(cfg));
+	write(`src/routes/${cfg.entry}/+layout.server.js`, svelteDocsLayoutServerTemplate(cfg));
+	write(`src/routes/${cfg.entry}/[...slug]/+page.svelte`, svelteDocsPageTemplate(cfg));
+	if (!readFileSafe(path.join(cwd, "src/routes/+layout.svelte"))) write("src/routes/+layout.svelte", svelteRootLayoutTemplate(globalCssRelPath));
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	const cssTheme = {
+		fumadocs: "fumadocs",
+		darksharp: "darksharp",
+		"pixel-border": "pixel-border",
+		colorful: "colorful",
+		darkbold: "darkbold",
+		shiny: "shiny",
+		greentree: "greentree",
+		default: "fumadocs"
+	}[cfg.theme] || "fumadocs";
+	if (existingGlobalCss) {
+		const injected = injectSvelteCssImport(existingGlobalCss, cssTheme);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, svelteGlobalCssTemplate(cssTheme));
+	write(`${cfg.entry}/page.md`, svelteWelcomePageTemplate(cfg));
+	write(`${cfg.entry}/installation/page.md`, svelteInstallationPageTemplate(cfg));
+	write(`${cfg.entry}/quickstart/page.md`, svelteQuickstartPageTemplate(cfg));
+}
+function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	write("src/lib/docs.config.ts", astroDocsConfigTemplate(cfg));
+	write("src/lib/docs.server.ts", astroDocsServerTemplate(cfg));
+	if (!fileExists(path.join(cwd, "astro.config.mjs")) && !fileExists(path.join(cwd, "astro.config.ts"))) write("astro.config.mjs", astroConfigTemplate(cfg.astroAdapter ?? "vercel"));
+	write(`src/pages/${cfg.entry}/index.astro`, astroDocsIndexTemplate(cfg));
+	write(`src/pages/${cfg.entry}/[...slug].astro`, astroDocsPageTemplate(cfg));
+	write(`src/pages/api/${cfg.entry}.ts`, astroApiRouteTemplate(cfg));
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	const cssTheme = {
+		fumadocs: "fumadocs",
+		darksharp: "darksharp",
+		"pixel-border": "pixel-border",
+		colorful: "colorful",
+		darkbold: "darkbold",
+		shiny: "shiny",
+		greentree: "greentree",
+		default: "fumadocs"
+	}[cfg.theme] || "fumadocs";
+	if (existingGlobalCss) {
+		const injected = injectAstroCssImport(existingGlobalCss, cssTheme);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, astroGlobalCssTemplate(cssTheme));
+	write(`${cfg.entry}/page.md`, astroWelcomePageTemplate(cfg));
+	write(`${cfg.entry}/installation/page.md`, astroInstallationPageTemplate(cfg));
+	write(`${cfg.entry}/quickstart/page.md`, astroQuickstartPageTemplate(cfg));
+}
+function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	write("docs.config.ts", nuxtDocsConfigTemplate(cfg));
+	write("server/utils/docs-server.ts", nuxtDocsServerTemplate(cfg));
+	write("server/api/docs.get.ts", nuxtServerApiDocsGetTemplate());
+	write("server/api/docs.post.ts", nuxtServerApiDocsPostTemplate());
+	write("server/api/docs/load.get.ts", nuxtServerApiDocsLoadTemplate());
+	write(`pages/${cfg.entry}/[[...slug]].vue`, nuxtDocsPageTemplate(cfg));
+	path.join(cwd, "nuxt.config.ts");
+	if (!fileExists(path.join(cwd, "nuxt.config.ts")) && !fileExists(path.join(cwd, "nuxt.config.js"))) write("nuxt.config.ts", nuxtConfigTemplate(cfg));
+	const cssTheme = {
+		fumadocs: "fumadocs",
+		darksharp: "darksharp",
+		"pixel-border": "pixel-border",
+		colorful: "colorful",
+		darkbold: "darkbold",
+		shiny: "shiny",
+		greentree: "greentree",
+		default: "fumadocs"
+	}[cfg.theme] || "fumadocs";
+	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
+	const existingGlobalCss = readFileSafe(globalCssAbsPath);
+	if (existingGlobalCss) {
+		const injected = injectNuxtCssImport(existingGlobalCss, cssTheme);
+		if (injected) {
+			writeFileSafe(globalCssAbsPath, injected, true);
+			written.push(globalCssRelPath + " (updated)");
+		} else skipped.push(globalCssRelPath + " (already configured)");
+	} else write(globalCssRelPath, nuxtGlobalCssTemplate(cssTheme));
+	write(`${cfg.entry}/page.md`, nuxtWelcomePageTemplate(cfg));
+	write(`${cfg.entry}/installation/page.md`, nuxtInstallationPageTemplate(cfg));
+	write(`${cfg.entry}/quickstart/page.md`, nuxtQuickstartPageTemplate(cfg));
+}
+
+//#endregion
+//#region src/cli/index.ts
+const args = process.argv.slice(2);
+const command = args[0];
+/** Parse flags like --template next, --name my-docs, --theme darksharp, --entry docs */
+function parseFlags(argv) {
+	const flags = {};
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg.startsWith("--") && arg.includes("=")) {
+			const [key, value] = arg.slice(2).split("=");
+			flags[key] = value;
+		} else if (arg.startsWith("--") && argv[i + 1] && !argv[i + 1].startsWith("--")) {
+			flags[arg.slice(2)] = argv[i + 1];
+			i++;
+		}
+	}
+	return flags;
+}
+async function main() {
+	const flags = parseFlags(args);
+	const initOptions = {
+		template: flags.template,
+		name: flags.name,
+		theme: flags.theme,
+		entry: flags.entry
+	};
+	if (!command || command === "init") await init(initOptions);
+	else if (command === "--help" || command === "-h") printHelp();
+	else if (command === "--version" || command === "-v") printVersion();
+	else {
+		console.error(pc.red(`Unknown command: ${command}`));
+		console.error();
+		printHelp();
+		process.exit(1);
+	}
+}
+function printHelp() {
+	console.log(`
+${pc.bold("@farming-labs/docs")} — Documentation framework CLI
+
+${pc.dim("Usage:")}
+  npx @farming-labs/docs ${pc.cyan("<command>")}
+
+${pc.dim("Commands:")}
+  ${pc.cyan("init")}    Scaffold docs in your project (default)
+
+${pc.dim("Supported frameworks:")}
+  Next.js, SvelteKit, Astro, Nuxt
 
-${pc.dim("Options:")}
-  ${pc.cyan("-h, --help")}       Show this help message
-  ${pc.cyan("-v, --version")}    Show version
+${pc.dim("Options for init:")}
+  ${pc.cyan("--template <name>")}  Bootstrap a project (${pc.dim("next")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}); use with ${pc.cyan("--name")}
+  ${pc.cyan("--name <project>")}  Project folder name when using ${pc.cyan("--template")}; prompt if omitted (e.g. ${pc.dim("my-docs")})
+  ${pc.cyan("--theme <name>")}     Skip theme prompt (e.g. ${pc.dim("darksharp")}, ${pc.dim("greentree")})
+  ${pc.cyan("--entry <path>")}     Skip entry path prompt (e.g. ${pc.dim("docs")})
+  ${pc.cyan("-h, --help")}         Show this help message
+  ${pc.cyan("-v, --version")}     Show version
 `);
 }
 function printVersion() {