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

package/dist/cli/index.mjs

@@ -1496,25 +1496,52 @@ async function init(options = {}) {
 			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";
-		p.log.step(`Cloning ${pc.cyan(`examples/${template}`)} from ${pc.cyan(EXAMPLES_REPO)}...`);
+		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`, cwd);
+			exec(`npx degit ${EXAMPLES_REPO}/examples/${template} . --force`, targetDir);
 		} catch (err) {
-			p.log.error("Failed to clone the example. Check your connection and that the repo exists.");
+			p.log.error("Failed to bootstrap. Check your connection and that the repo exists.");
 			process.exit(1);
 		}
-		p.log.success(`Cloned ${templateLabel} example. Installing dependencies...`);
-		const pm = detectPackageManager(cwd);
+		p.log.success(`Bootstrapped ${pc.cyan(`'${projectName}'`)}. Installing dependencies...`);
+		const pm = detectPackageManager(targetDir);
 		try {
-			if (pm === "pnpm") exec("pnpm install", cwd);
-			else if (pm === "yarn") exec("yarn install", cwd);
-			else if (pm === "bun") exec("bun install", cwd);
-			else exec("npm install", cwd);
+			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.");
 		}
-		p.outro(pc.green(`Done! Run ${pc.cyan(pm === "yarn" ? "yarn dev" : pm === "bun" ? "bun dev" : `${pm} run dev`)} to start the dev server.`));
+		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);
@@ -1930,7 +1957,7 @@ function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 //#region src/cli/index.ts
 const args = process.argv.slice(2);
 const command = args[0];
-/** Parse flags like --template next, --theme darksharp, --entry docs */
+/** 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++) {
@@ -1949,6 +1976,7 @@ async function main() {
 	const flags = parseFlags(args);
 	const initOptions = {
 		template: flags.template,
+		name: flags.name,
 		theme: flags.theme,
 		entry: flags.entry
 	};
@@ -1976,7 +2004,8 @@ ${pc.dim("Supported frameworks:")}
   Next.js, SvelteKit, Astro, Nuxt
 
 ${pc.dim("Options for init:")}
-  ${pc.cyan("--template <name>")}  Clone an example (${pc.dim("next")}, ${pc.dim("nuxt")}, ${pc.dim("sveltekit")}, ${pc.dim("astro")}) and get started
+  ${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

package/package.json

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