add starlight docs addon

apps/cli/src/helpers/addons-setup.ts

@@ -7,6 +7,7 @@ import type {
 	ProjectPackageManager,
 } from "../types";
 import { addPackageDependency } from "../utils/add-package-deps";
+import { setupStarlight } from "./starlight-setup";
 import { setupTauri } from "./tauri-setup";
 
 export async function setupAddons(
@@ -30,6 +31,9 @@ export async function setupAddons(
 	if (addons.includes("husky")) {
 		await setupHusky(projectDir);
 	}
+	if (addons.includes("starlight")) {
+		await setupStarlight(projectDir, packageManager);
+	}
 }
 
 export function getWebAppDir(

apps/cli/src/helpers/mongodb-atlas-setup.ts

@@ -36,10 +36,9 @@ async function initMongoDBAtlas(
 			stdio: "inherit",
 		});
 
-		log.info(pc.yellow("Please enter your connection string"));
-
 		const connectionString = await text({
 			message: "Paste your complete MongoDB connection string:",
+			placeholder: "mongodb://USERNAME:PASSWORD@HOST/DATABASE",
 			validate(value) {
 				if (!value) return "Please enter a connection string";
 				if (!value.startsWith("mongodb")) {

apps/cli/src/helpers/post-installation.ts

@@ -43,6 +43,9 @@ export function displayPostInstallInstructions(
 		addons?.includes("pwa") && frontends?.includes("react-router")
 			? getPwaInstructions()
 			: "";
+	const starlightInstructions = addons?.includes("starlight")
+		? getStarlightInstructions(runCmd)
+		: "";
 
 	const hasTanstackRouter = frontends?.includes("tanstack-router");
 	const hasTanstackStart = frontends?.includes("tanstack-start");
@@ -64,7 +67,7 @@ ${
 		? `${hasWebFrontend ? `${pc.cyan("•")} Frontend: http://localhost:${webPort}\n` : ""}`
 		: `${pc.yellow("NOTE:")} You are creating a backend-only app (no frontend selected)\n`
 }${pc.cyan("•")} API: http://localhost:3000
-${nativeInstructions ? `\n${nativeInstructions.trim()}` : ""}${databaseInstructions ? `\n${databaseInstructions.trim()}` : ""}${tauriInstructions ? `\n${tauriInstructions.trim()}` : ""}${lintingInstructions ? `\n${lintingInstructions.trim()}` : ""}${pwaInstructions ? `\n${pwaInstructions.trim()}` : ""}
+${addons?.includes("starlight") ? `${pc.cyan("•")} Docs: http://localhost:4321\n` : ""}${nativeInstructions ? `\n${nativeInstructions.trim()}` : ""}${databaseInstructions ? `\n${databaseInstructions.trim()}` : ""}${tauriInstructions ? `\n${tauriInstructions.trim()}` : ""}${lintingInstructions ? `\n${lintingInstructions.trim()}` : ""}${pwaInstructions ? `\n${pwaInstructions.trim()}` : ""}${starlightInstructions ? `\n${starlightInstructions.trim()}` : ""}
 \n${pc.bold("Like Better-T Stack?")} Please consider giving us a star on GitHub:
 ${pc.cyan("https://github.com/AmanVarshney01/create-better-t-stack")}`,
 		"Next steps",
@@ -120,3 +123,7 @@ function getTauriInstructions(runCmd?: string): string {
 function getPwaInstructions(): string {
 	return `${pc.bold("PWA with React Router v7:")}\n${pc.yellow("NOTE:")} There is a known compatibility issue between VitePWA and React Router v7.\nSee: https://github.com/vite-pwa/vite-plugin-pwa/issues/809\n`;
 }
+
+function getStarlightInstructions(runCmd?: string): string {
+	return `${pc.bold("Documentation with Starlight:")}\n${pc.cyan("•")} Start docs site: ${`cd apps/docs && ${runCmd} dev`}\n${pc.cyan("•")} Build docs site: ${`cd apps/docs && ${runCmd} build`}\n`;
+}

apps/cli/src/helpers/starlight-setup.ts

@@ -0,0 +1,64 @@
+import path from "node:path";
+import { log, spinner } from "@clack/prompts";
+import { execa } from "execa";
+import pc from "picocolors";
+import type { ProjectPackageManager } from "../types";
+
+export async function setupStarlight(
+	projectDir: string,
+	packageManager: ProjectPackageManager,
+): Promise<void> {
+	const s = spinner();
+
+	try {
+		s.start("Setting up Starlight documentation site...");
+
+		let cmd: string;
+		let args: string[];
+
+		switch (packageManager) {
+			case "npm":
+				cmd = "npx";
+				args = ["create-astro@latest"];
+				break;
+			case "pnpm":
+				cmd = "pnpm";
+				args = ["dlx", "create-astro@latest"];
+				break;
+			case "bun":
+				cmd = "bunx";
+				args = ["create-astro@latest"];
+				break;
+			default:
+				cmd = "npx";
+				args = ["create-astro@latest"];
+		}
+
+		args = [
+			...args,
+			"docs",
+			"--template",
+			"starlight",
+			"--no-install",
+			"--add",
+			"tailwind",
+			"--no-git",
+			"--skip-houston",
+		];
+
+		await execa(cmd, args, {
+			cwd: path.join(projectDir, "apps"),
+			env: {
+				CI: "true",
+			},
+		});
+
+		s.stop("Starlight documentation site setup successfully!");
+	} catch (error) {
+		s.stop(pc.red("Failed to set up Starlight documentation site"));
+		if (error instanceof Error) {
+			log.error(pc.red(error.message));
+		}
+		throw error;
+	}
+}