@farming-labs/docs 0.0.15 → 0.0.17

package/dist/cli/index.mjs

@@ -214,6 +214,49 @@ const THEME_INFO = {
 function getThemeInfo(theme) {
 	return THEME_INFO[theme] ?? THEME_INFO.fumadocs;
 }
+function getThemeExportName(themeName) {
+	const base = themeName.replace(/\.ts$/i, "").trim();
+	if (!base) return "customTheme";
+	return base.replace(/-([a-z])/g, (_, c) => c.toUpperCase()).replace(/^./, (c) => c.toLowerCase());
+}
+function getCustomThemeCssImportPath(globalCssRelPath, themeName) {
+	if (globalCssRelPath.startsWith("app/")) return `../themes/${themeName}.css`;
+	if (globalCssRelPath.startsWith("src/")) return `../../themes/${themeName}.css`;
+	return `../themes/${themeName}.css`;
+}
+/** Content for themes/{name}.ts - createTheme with the given name */
+function customThemeTsTemplate(themeName) {
+	return `\
+import { createTheme } from "@farming-labs/docs";
+
+export const ${getThemeExportName(themeName)} = createTheme({
+  name: "${themeName.replace(/\.ts$/i, "")}",
+  ui: {
+    colors: {
+      primary: "#e11d48",
+      background: "#09090b",
+      foreground: "#fafafa",
+      muted: "#71717a",
+      border: "#27272a",
+    },
+    radius: "0.5rem",
+  },
+});
+`;
+}
+function customThemeCssTemplate(themeName) {
+	return `\
+/* Custom theme: ${themeName} - edit variables and selectors as needed */
+@import "@farming-labs/theme/presets/black";
+
+.dark {
+  --color-fd-primary: #e11d48;
+  --color-fd-background: #09090b;
+  --color-fd-border: #27272a;
+  --radius: 0.5rem;
+}
+`;
+}
 /** Config import for Next.js app/layout.tsx → root docs.config */
 function nextRootLayoutConfigImport(useAlias) {
 	return useAlias ? "@/docs.config" : "../docs.config";
@@ -250,6 +293,27 @@ function astroPageServerImport(useAlias, depth) {
 	return `${"../".repeat(depth)}lib/docs.server`;
 }
 function docsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "${cfg.useAlias ? "@/themes/" + cfg.customThemeName.replace(/\.ts$/i, "") : "./themes/" + cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
 	const t = getThemeInfo(cfg.theme);
 	return `\
 import { defineDocs } from "@farming-labs/docs";
@@ -354,16 +418,21 @@ function injectRootProviderIntoLayout(content) {
 	}
 	return out === content ? null : out;
 }
-function globalCssTemplate(theme) {
+function globalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "tailwindcss";
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
 	return `\
 @import "tailwindcss";
 @import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";
 `;
 }
-function injectCssImport(existingContent, theme) {
-	const importLine = `@import "@farming-labs/theme/${getThemeInfo(theme).nextCssImport}/css";`;
+function injectCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = theme === "custom" && customThemeName && globalCssRelPath ? `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";` : `@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;
+	if (theme !== "custom" && existingContent.includes("@farming-labs/theme/") && existingContent.includes("/css")) return null;
+	if (theme === "custom" && existingContent.includes("themes/") && 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);
@@ -602,6 +671,34 @@ Deploy to Vercel, Netlify, or any Node.js hosting platform.
 `;
 }
 function svelteDocsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "${"../../themes/" + cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
 	const t = getThemeInfo(cfg.theme);
 	return `\
 import { defineDocs } from "@farming-labs/docs";
@@ -692,17 +789,23 @@ function svelteRootLayoutTemplate(globalCssRelPath) {
 {@render children()}
 `;
 }
-function svelteGlobalCssTemplate(theme) {
+function svelteGlobalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
 	return `\
 @import "@farming-labs/svelte-theme/${theme}/css";
 `;
 }
-function svelteCssImportLine(theme) {
+function svelteCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
 	return `@import "@farming-labs/svelte-theme/${theme}/css";`;
 }
-function injectSvelteCssImport(existingContent, theme) {
-	const importLine = svelteCssImportLine(theme);
+function injectSvelteCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = svelteCssImportLine(theme, customThemeName, globalCssRelPath);
 	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && existingContent.includes("@farming-labs/svelte-theme/") && existingContent.includes("/css")) return null;
+	if (theme === "custom" && existingContent.includes("themes/") && 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);
@@ -876,6 +979,35 @@ Deploy to Vercel, Netlify, or any Node.js hosting platform.
 `;
 }
 function astroDocsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "${"../../themes/" + cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
 	const t = getThemeInfo(cfg.theme);
 	return `\
 import { defineDocs } from "@farming-labs/docs";
@@ -1025,17 +1157,23 @@ export const POST: APIRoute = async ({ request }) => {
 };
 `;
 }
-function astroGlobalCssTemplate(theme) {
+function astroGlobalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
 	return `\
 @import "@farming-labs/astro-theme/${theme}/css";
 `;
 }
-function astroCssImportLine(theme) {
+function astroCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
 	return `@import "@farming-labs/astro-theme/${theme}/css";`;
 }
-function injectAstroCssImport(existingContent, theme) {
-	const importLine = astroCssImportLine(theme);
+function injectAstroCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = astroCssImportLine(theme, customThemeName, globalCssRelPath);
 	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && existingContent.includes("@farming-labs/astro-theme/") && existingContent.includes("/css")) return null;
+	if (theme === "custom" && existingContent.includes("themes/") && 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);
@@ -1197,6 +1335,35 @@ Deploy to Vercel, Netlify, or any Node.js hosting platform.
 `;
 }
 function nuxtDocsConfigTemplate(cfg) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const exportName = getThemeExportName(cfg.customThemeName);
+		return `\
+import { defineDocs } from "@farming-labs/docs";
+import { ${exportName} } from "${cfg.useAlias ? "~/themes/" + cfg.customThemeName.replace(/\.ts$/i, "") : "./themes/" + cfg.customThemeName.replace(/\.ts$/i, "")}";
+
+export default defineDocs({
+  entry: "${cfg.entry}",
+  contentDir: "${cfg.entry}",
+  theme: ${exportName}({
+    ui: {
+      colors: { primary: "#6366f1" },
+    },
+  }),
+
+  nav: {
+    title: "${cfg.projectName}",
+    url: "/${cfg.entry}",
+  },
+
+  breadcrumb: { enabled: true },
+
+  metadata: {
+    titleTemplate: "%s – ${cfg.projectName}",
+    description: "Documentation for ${cfg.projectName}",
+  },
+});
+`;
+	}
 	const t = getThemeInfo(cfg.theme);
 	return `\
 import { defineDocs } from "@farming-labs/docs";
@@ -1496,17 +1663,23 @@ pnpm build
 Deploy to Vercel, Netlify, or any Node.js hosting platform.
 `;
 }
-function nuxtGlobalCssTemplate(theme) {
+function nuxtGlobalCssTemplate(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `\
+@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";
+`;
 	return `\
 @import "@farming-labs/nuxt-theme/${theme}/css";
 `;
 }
-function nuxtCssImportLine(theme) {
+function nuxtCssImportLine(theme, customThemeName, globalCssRelPath) {
+	if (theme === "custom" && customThemeName && globalCssRelPath) return `@import "${getCustomThemeCssImportPath(globalCssRelPath, customThemeName.replace(/\.css$/i, ""))}";`;
 	return `@import "@farming-labs/nuxt-theme/${theme}/css";`;
 }
-function injectNuxtCssImport(existingContent, theme) {
-	const importLine = nuxtCssImportLine(theme);
+function injectNuxtCssImport(existingContent, theme, customThemeName, globalCssRelPath) {
+	const importLine = nuxtCssImportLine(theme, customThemeName, globalCssRelPath);
 	if (existingContent.includes(importLine)) return null;
+	if (theme !== "custom" && existingContent.includes("@farming-labs/nuxt-theme/") && existingContent.includes("/css")) return null;
+	if (theme === "custom" && existingContent.includes("themes/") && 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);
@@ -1526,11 +1699,65 @@ const VALID_TEMPLATES = [
 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 projectType = "existing";
+	if (!options.template) {
+		const projectTypeAnswer = await p.select({
+			message: "Are you adding docs to an existing project or starting fresh?",
+			options: [{
+				value: "existing",
+				label: "Existing project",
+				hint: "Add docs to the current app in this directory"
+			}, {
+				value: "fresh",
+				label: "Fresh project",
+				hint: "Bootstrap a new app from a template (Next, Nuxt, SvelteKit, Astro)"
+			}]
+		});
+		if (p.isCancel(projectTypeAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		projectType = projectTypeAnswer;
+	}
+	if (projectType === "fresh" || options.template) {
+		let template;
+		if (options.template) {
+			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);
+			}
+		} else {
+			const templateAnswer = await p.select({
+				message: "Which framework would you like to use?",
+				options: [
+					{
+						value: "next",
+						label: "Next.js",
+						hint: "React with App Router"
+					},
+					{
+						value: "nuxt",
+						label: "Nuxt",
+						hint: "Vue 3 with file-based routing"
+					},
+					{
+						value: "sveltekit",
+						label: "SvelteKit",
+						hint: "Svelte with file-based routing"
+					},
+					{
+						value: "astro",
+						label: "Astro",
+						hint: "Content-focused with islands"
+					}
+				]
+			});
+			if (p.isCancel(templateAnswer)) {
+				p.outro(pc.red("Init cancelled."));
+				process.exit(0);
+			}
+			template = templateAnswer;
 		}
 		let projectName = options.name?.trim();
 		if (!projectName) {
@@ -1649,6 +1876,11 @@ async function init(options = {}) {
 				value: "greentree",
 				label: "GreenTree",
 				hint: "Emerald green accent, Inter font, Mintlify-inspired"
+			},
+			{
+				value: "custom",
+				label: "Create your own theme",
+				hint: "Scaffold a new theme file + CSS in themes/ (name asked next)"
 			}
 		]
 	});
@@ -1656,6 +1888,26 @@ async function init(options = {}) {
 		p.outro(pc.red("Init cancelled."));
 		process.exit(0);
 	}
+	let customThemeName;
+	if (theme === "custom") {
+		const nameAnswer = await p.text({
+			message: "Theme name? (we'll create themes/<name>.ts and themes/<name>.css)",
+			placeholder: "my-theme",
+			defaultValue: "my-theme",
+			validate: (value) => {
+				const v = (value ?? "").trim().replace(/\.(ts|css)$/i, "");
+				if (!v) return "Theme name is required";
+				if (v.includes("/") || v.includes("\\")) return "Theme name cannot contain path separators";
+				if (v.includes(" ")) return "Theme name cannot contain spaces";
+				if (!/^[a-z0-9_-]+$/i.test(v)) return "Use only letters, numbers, hyphens, and underscores";
+			}
+		});
+		if (p.isCancel(nameAnswer)) {
+			p.outro(pc.red("Init cancelled."));
+			process.exit(0);
+		}
+		customThemeName = nameAnswer.trim().replace(/\.(ts|css)$/i, "");
+	}
 	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)}`,
@@ -1696,21 +1948,22 @@ async function init(options = {}) {
 		}
 		astroAdapter = adapter;
 	}
+	const defaultEntry = "docs";
 	const entry = await p.text({
 		message: "Where should your docs live?",
-		placeholder: "docs",
-		defaultValue: "docs",
+		placeholder: defaultEntry,
+		defaultValue: defaultEntry,
 		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";
+			const v = (value ?? "").trim();
+			if (v.startsWith("/")) return "Use a relative path (no leading /)";
+			if (v.includes(" ")) return "Path cannot contain spaces";
 		}
 	});
 	if (p.isCancel(entry)) {
 		p.outro(pc.red("Init cancelled."));
 		process.exit(0);
 	}
-	const entryPath = entry;
+	const entryPath = entry.trim() || defaultEntry;
 	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";
@@ -1731,27 +1984,29 @@ async function init(options = {}) {
 		}
 		globalCssRelPath = picked;
 	} else {
-		const cssPath = await p.text({
+		const cssPathAnswer = 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";
+				const v = (value ?? "").trim();
+				if (v && !v.endsWith(".css")) return "Path must end with .css";
 			}
 		});
-		if (p.isCancel(cssPath)) {
+		if (p.isCancel(cssPathAnswer)) {
 			p.outro(pc.red("Init cancelled."));
 			process.exit(0);
 		}
-		globalCssRelPath = cssPath;
+		globalCssRelPath = cssPathAnswer.trim() || defaultCssPath;
 	}
 	const pkgJsonContent = readFileSafe(path.join(cwd, "package.json"));
 	const pkgJson = pkgJsonContent ? JSON.parse(pkgJsonContent) : { name: "my-project" };
+	const projectName = pkgJson.name || "My Project";
 	const cfg = {
 		entry: entryPath,
 		theme,
-		projectName: pkgJson.name || "My Project",
+		customThemeName,
+		projectName,
 		framework,
 		useAlias,
 		astroAdapter
@@ -1864,6 +2119,11 @@ async function init(options = {}) {
 	}
 }
 function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
 	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) {
@@ -1887,12 +2147,12 @@ function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
 	const existingGlobalCss = readFileSafe(globalCssAbsPath);
 	if (existingGlobalCss) {
-		const injected = injectCssImport(existingGlobalCss, cfg.theme);
+		const injected = injectCssImport(existingGlobalCss, cfg.theme, cfg.customThemeName, globalCssRelPath);
 		if (injected) {
 			writeFileSafe(globalCssAbsPath, injected, true);
 			written.push(globalCssRelPath + " (updated)");
 		} else skipped.push(globalCssRelPath + " (already configured)");
-	} else write(globalCssRelPath, globalCssTemplate(cfg.theme));
+	} else write(globalCssRelPath, globalCssTemplate(cfg.theme, cfg.customThemeName, globalCssRelPath));
 	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));
@@ -1901,6 +2161,11 @@ function scaffoldNextJs(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	write(`app/${cfg.entry}/quickstart/page.mdx`, quickstartPageTemplate(cfg));
 }
 function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
 	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));
@@ -1920,17 +2185,22 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 		default: "fumadocs"
 	}[cfg.theme] || "fumadocs";
 	if (existingGlobalCss) {
-		const injected = injectSvelteCssImport(existingGlobalCss, cssTheme);
+		const injected = cfg.theme === "custom" && cfg.customThemeName ? injectSvelteCssImport(existingGlobalCss, "custom", cfg.customThemeName, globalCssRelPath) : injectSvelteCssImport(existingGlobalCss, cssTheme);
 		if (injected) {
 			writeFileSafe(globalCssAbsPath, injected, true);
 			written.push(globalCssRelPath + " (updated)");
 		} else skipped.push(globalCssRelPath + " (already configured)");
-	} else write(globalCssRelPath, svelteGlobalCssTemplate(cssTheme));
+	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? svelteGlobalCssTemplate("custom", cfg.customThemeName, 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) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
 	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"));
@@ -1950,17 +2220,22 @@ function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
 		default: "fumadocs"
 	}[cfg.theme] || "fumadocs";
 	if (existingGlobalCss) {
-		const injected = injectAstroCssImport(existingGlobalCss, cssTheme);
+		const injected = cfg.theme === "custom" && cfg.customThemeName ? injectAstroCssImport(existingGlobalCss, "custom", cfg.customThemeName, globalCssRelPath) : injectAstroCssImport(existingGlobalCss, cssTheme);
 		if (injected) {
 			writeFileSafe(globalCssAbsPath, injected, true);
 			written.push(globalCssRelPath + " (updated)");
 		} else skipped.push(globalCssRelPath + " (already configured)");
-	} else write(globalCssRelPath, astroGlobalCssTemplate(cssTheme));
+	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? astroGlobalCssTemplate("custom", cfg.customThemeName, 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) {
+	if (cfg.theme === "custom" && cfg.customThemeName) {
+		const baseName = cfg.customThemeName.replace(/\.(ts|css)$/i, "");
+		write(`themes/${baseName}.ts`, customThemeTsTemplate(baseName));
+		write(`themes/${baseName}.css`, customThemeCssTemplate(baseName));
+	}
 	write("docs.config.ts", nuxtDocsConfigTemplate(cfg));
 	write("server/utils/docs-server.ts", nuxtDocsServerTemplate(cfg));
 	write("server/api/docs.get.ts", nuxtServerApiDocsGetTemplate());
@@ -1982,12 +2257,12 @@ function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	const globalCssAbsPath = path.join(cwd, globalCssRelPath);
 	const existingGlobalCss = readFileSafe(globalCssAbsPath);
 	if (existingGlobalCss) {
-		const injected = injectNuxtCssImport(existingGlobalCss, cssTheme);
+		const injected = cfg.theme === "custom" && cfg.customThemeName ? injectNuxtCssImport(existingGlobalCss, "custom", cfg.customThemeName, globalCssRelPath) : injectNuxtCssImport(existingGlobalCss, cssTheme);
 		if (injected) {
 			writeFileSafe(globalCssAbsPath, injected, true);
 			written.push(globalCssRelPath + " (updated)");
 		} else skipped.push(globalCssRelPath + " (already configured)");
-	} else write(globalCssRelPath, nuxtGlobalCssTemplate(cssTheme));
+	} else write(globalCssRelPath, cfg.theme === "custom" && cfg.customThemeName ? nuxtGlobalCssTemplate("custom", cfg.customThemeName, 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));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",