create-better-t-stack 2.29.3 → 2.30.0

package/dist/index.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 import { cancel, confirm, group, groupMultiselect, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
-import consola, { consola as consola$1 } from "consola";
 import pc from "picocolors";
 import { createCli, trpcServer } from "trpc-cli";
 import z from "zod";
 import path from "node:path";
 import fs from "fs-extra";
 import { fileURLToPath } from "node:url";
+import consola, { consola as consola$1 } from "consola";
 import gradient from "gradient-string";
 import * as JSONC from "jsonc-parser";
 import { $, execa } from "execa";
+import handlebars from "handlebars";
 import { IndentationText, Node, Project, QuoteKind, SyntaxKind } from "ts-morph";
 import { globby } from "globby";
-import handlebars from "handlebars";
 import os from "node:os";
 
 //#region src/utils/get-package-manager.ts
@@ -136,19 +136,11 @@ const ADDON_COMPATIBILITY = {
 	turborepo: [],
 	starlight: [],
 	ultracite: [],
+	"vibe-rules": [],
 	oxlint: [],
 	fumadocs: [],
 	none: []
 };
-const WEB_FRAMEWORKS = [
-	"tanstack-router",
-	"react-router",
-	"tanstack-start",
-	"next",
-	"nuxt",
-	"svelte",
-	"solid"
-];
 
 //#endregion
 //#region src/types.ts
@@ -179,7 +171,7 @@ const RuntimeSchema = z.enum([
 	"node",
 	"workers",
 	"none"
-]).describe("Runtime environment (workers only available with hono backend and drizzle orm)");
+]).describe("Runtime environment");
 const FrontendSchema = z.enum([
 	"tanstack-router",
 	"react-router",
@@ -198,6 +190,7 @@ const AddonsSchema = z.enum([
 	"starlight",
 	"biome",
 	"husky",
+	"vibe-rules",
 	"turborepo",
 	"fumadocs",
 	"ultracite",
@@ -267,6 +260,22 @@ function getCompatibleAddons(allAddons, frontend, existingAddons = []) {
 	});
 }
 
+//#endregion
+//#region src/utils/errors.ts
+function exitWithError(message) {
+	consola$1.error(pc.red(message));
+	process.exit(1);
+}
+function exitCancelled(message = "Operation cancelled") {
+	cancel(pc.red(message));
+	process.exit(0);
+}
+function handleError(error, fallbackMessage) {
+	const message = error instanceof Error ? error.message : fallbackMessage || String(error);
+	consola$1.error(pc.red(message));
+	process.exit(1);
+}
+
 //#endregion
 //#region src/prompts/addons.ts
 function getAddonDisplay(addon) {
@@ -297,6 +306,10 @@ function getAddonDisplay(addon) {
 			label = "Ultracite";
 			hint = "Zero-config Biome preset with AI integration";
 			break;
+		case "vibe-rules":
+			label = "vibe-rules";
+			hint = "Install and apply BTS rules to editors";
+			break;
 		case "husky":
 			label = "Husky";
 			hint = "Modern native Git hooks made easy";
@@ -326,6 +339,7 @@ const ADDON_GROUPS = {
 		"ultracite"
 	],
 	Other: [
+		"vibe-rules",
 		"turborepo",
 		"pwa",
 		"tauri",
@@ -365,10 +379,7 @@ async function getAddonsChoice(addons, frontends) {
 		required: false,
 		selectableGroups: false
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 async function getAddonsToAdd(frontend, existingAddons = []) {
@@ -400,56 +411,154 @@ async function getAddonsToAdd(frontend, existingAddons = []) {
 		required: false,
 		selectableGroups: false
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
+//#endregion
+//#region src/utils/compatibility.ts
+const WEB_FRAMEWORKS = [
+	"tanstack-router",
+	"react-router",
+	"tanstack-start",
+	"next",
+	"nuxt",
+	"svelte",
+	"solid"
+];
+
+//#endregion
+//#region src/utils/compatibility-rules.ts
+function isWebFrontend(value) {
+	return WEB_FRAMEWORKS.includes(value);
+}
+function splitFrontends(values = []) {
+	const web = values.filter((f) => isWebFrontend(f));
+	const native = values.filter((f) => f === "native-nativewind" || f === "native-unistyles");
+	return {
+		web,
+		native
+	};
+}
+function ensureSingleWebAndNative(frontends) {
+	const { web, native } = splitFrontends(frontends);
+	if (web.length > 1) exitWithError("Cannot select multiple web frameworks. Choose only one of: tanstack-router, tanstack-start, react-router, next, nuxt, svelte, solid");
+	if (native.length > 1) exitWithError("Cannot select multiple native frameworks. Choose only one of: native-nativewind, native-unistyles");
+}
+function validateWorkersCompatibility(providedFlags, options, config) {
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && config.backend !== "hono") exitWithError(`Cloudflare Workers runtime (--runtime workers) is only supported with Hono backend (--backend hono). Current backend: ${config.backend}. Please use '--backend hono' or choose a different runtime.`);
+	if (providedFlags.has("backend") && config.backend && config.backend !== "hono" && config.runtime === "workers") exitWithError(`Backend '${config.backend}' is not compatible with Cloudflare Workers runtime. Cloudflare Workers runtime is only supported with Hono backend. Please use '--backend hono' or choose a different runtime.`);
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.orm && config.orm !== "drizzle" && config.orm !== "none") exitWithError(`Cloudflare Workers runtime (--runtime workers) is only supported with Drizzle ORM (--orm drizzle) or no ORM (--orm none). Current ORM: ${config.orm}. Please use '--orm drizzle', '--orm none', or choose a different runtime.`);
+	if (providedFlags.has("orm") && config.orm && config.orm !== "drizzle" && config.orm !== "none" && config.runtime === "workers") exitWithError(`ORM '${config.orm}' is not compatible with Cloudflare Workers runtime. Cloudflare Workers runtime is only supported with Drizzle ORM or no ORM. Please use '--orm drizzle', '--orm none', or choose a different runtime.`);
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.database === "mongodb") exitWithError("Cloudflare Workers runtime (--runtime workers) is not compatible with MongoDB database. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle ORM. Please use a different database or runtime.");
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.dbSetup === "docker") exitWithError("Cloudflare Workers runtime (--runtime workers) is not compatible with Docker setup. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
+	if (providedFlags.has("database") && config.database === "mongodb" && config.runtime === "workers") exitWithError("MongoDB database is not compatible with Cloudflare Workers runtime. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle ORM. Please use a different database or runtime.");
+	if (providedFlags.has("dbSetup") && options.dbSetup === "docker" && config.runtime === "workers") exitWithError("Docker setup (--db-setup docker) is not compatible with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
+}
+function coerceBackendPresets(config) {
+	if (config.backend === "convex") {
+		config.auth = false;
+		config.database = "none";
+		config.orm = "none";
+		config.api = "none";
+		config.runtime = "none";
+		config.dbSetup = "none";
+		config.examples = ["todo"];
+	}
+	if (config.backend === "none") {
+		config.auth = false;
+		config.database = "none";
+		config.orm = "none";
+		config.api = "none";
+		config.runtime = "none";
+		config.dbSetup = "none";
+		config.examples = [];
+	}
+}
+function incompatibleFlagsForBackend(backend, providedFlags, options) {
+	const list = [];
+	if (backend === "convex") {
+		if (providedFlags.has("auth") && options.auth === true) list.push("--auth");
+		if (providedFlags.has("database") && options.database !== "none") list.push(`--database ${options.database}`);
+		if (providedFlags.has("orm") && options.orm !== "none") list.push(`--orm ${options.orm}`);
+		if (providedFlags.has("api") && options.api !== "none") list.push(`--api ${options.api}`);
+		if (providedFlags.has("runtime") && options.runtime !== "none") list.push(`--runtime ${options.runtime}`);
+		if (providedFlags.has("dbSetup") && options.dbSetup !== "none") list.push(`--db-setup ${options.dbSetup}`);
+	}
+	if (backend === "none") {
+		if (providedFlags.has("auth") && options.auth === true) list.push("--auth");
+		if (providedFlags.has("database") && options.database !== "none") list.push(`--database ${options.database}`);
+		if (providedFlags.has("orm") && options.orm !== "none") list.push(`--orm ${options.orm}`);
+		if (providedFlags.has("api") && options.api !== "none") list.push(`--api ${options.api}`);
+		if (providedFlags.has("runtime") && options.runtime !== "none") list.push(`--runtime ${options.runtime}`);
+		if (providedFlags.has("dbSetup") && options.dbSetup !== "none") list.push(`--db-setup ${options.dbSetup}`);
+		if (providedFlags.has("examples") && options.examples) {
+			const hasNonNoneExamples = options.examples.some((ex) => ex !== "none");
+			if (hasNonNoneExamples) list.push("--examples");
+		}
+	}
+	return list;
+}
+function validateApiFrontendCompatibility(api, frontends = []) {
+	const includesNuxt = frontends.includes("nuxt");
+	const includesSvelte = frontends.includes("svelte");
+	const includesSolid = frontends.includes("solid");
+	if ((includesNuxt || includesSvelte || includesSolid) && api === "trpc") exitWithError(`tRPC API is not supported with '${includesNuxt ? "nuxt" : includesSvelte ? "svelte" : "solid"}' frontend. Please use --api orpc or --api none or remove '${includesNuxt ? "nuxt" : includesSvelte ? "svelte" : "solid"}' from --frontend.`);
+}
+function isFrontendAllowedWithBackend(frontend, backend) {
+	if (backend === "convex" && frontend === "solid") return false;
+	return true;
+}
+function allowedApisForFrontends(frontends = []) {
+	const includesNuxt = frontends.includes("nuxt");
+	const includesSvelte = frontends.includes("svelte");
+	const includesSolid = frontends.includes("solid");
+	const base = [
+		"trpc",
+		"orpc",
+		"none"
+	];
+	if (includesNuxt || includesSvelte || includesSolid) return ["orpc", "none"];
+	return base;
+}
+function isExampleTodoAllowed(backend, database) {
+	return !(backend !== "convex" && backend !== "none" && database === "none");
+}
+function isExampleAIAllowed(backend, frontends = []) {
+	const includesSolid = frontends.includes("solid");
+	if (backend === "elysia") return false;
+	if (includesSolid) return false;
+	return true;
+}
+function validateWebDeployRequiresWebFrontend(webDeploy, hasWebFrontendFlag) {
+	if (webDeploy && webDeploy !== "none" && !hasWebFrontendFlag) exitWithError("'--web-deploy' requires a web frontend. Please select a web frontend or set '--web-deploy none'.");
+}
+
 //#endregion
 //#region src/prompts/api.ts
 async function getApiChoice(Api, frontend, backend) {
 	if (backend === "convex" || backend === "none") return "none";
-	if (Api) return Api;
-	const includesNuxt = frontend?.includes("nuxt");
-	const includesSvelte = frontend?.includes("svelte");
-	const includesSolid = frontend?.includes("solid");
-	let apiOptions = [
-		{
-			value: "trpc",
-			label: "tRPC",
-			hint: "End-to-end typesafe APIs made easy"
-		},
-		{
-			value: "orpc",
-			label: "oRPC",
-			hint: "End-to-end type-safe APIs that adhere to OpenAPI standards"
-		},
-		{
-			value: "none",
-			label: "None",
-			hint: "No API layer (e.g. for full-stack frameworks like Next.js with Route Handlers)"
-		}
-	];
-	if (includesNuxt || includesSvelte || includesSolid) apiOptions = [{
+	const allowed = allowedApisForFrontends(frontend ?? []);
+	if (Api) return allowed.includes(Api) ? Api : allowed[0];
+	const apiOptions = allowed.map((a) => a === "trpc" ? {
+		value: "trpc",
+		label: "tRPC",
+		hint: "End-to-end typesafe APIs made easy"
+	} : a === "orpc" ? {
 		value: "orpc",
 		label: "oRPC",
-		hint: `End-to-end type-safe APIs (Recommended for ${includesNuxt ? "Nuxt" : includesSvelte ? "Svelte" : "Solid"} frontend)`
-	}, {
+		hint: "End-to-end type-safe APIs that adhere to OpenAPI standards"
+	} : {
 		value: "none",
 		label: "None",
-		hint: "No API layer"
-	}];
+		hint: "No API layer (e.g. for full-stack frameworks like Next.js with Route Handlers)"
+	});
 	const apiType = await select({
 		message: "Select API type",
 		options: apiOptions,
 		initialValue: apiOptions[0].value
 	});
-	if (isCancel(apiType)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(apiType)) return exitCancelled("Operation cancelled");
 	return apiType;
 }
 
@@ -463,10 +572,7 @@ async function getAuthChoice(auth, hasDatabase, backend) {
 		message: "Add authentication with Better-Auth?",
 		initialValue: DEFAULT_CONFIG.auth
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -517,10 +623,7 @@ async function getBackendFrameworkChoice(backendFramework, frontends) {
 		options: backendOptions,
 		initialValue: DEFAULT_CONFIG.backend
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -561,10 +664,7 @@ async function getDatabaseChoice(database, backend, runtime) {
 		options: databaseOptions,
 		initialValue: DEFAULT_CONFIG.database
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -652,10 +752,7 @@ async function getDBSetupChoice(databaseType, dbSetup, orm, backend, runtime) {
 		options,
 		initialValue: "none"
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -670,26 +767,25 @@ async function getExamplesChoice(examples, database, frontends, backend, api) {
 	const noFrontendSelected = !frontends || frontends.length === 0;
 	if (noFrontendSelected) return [];
 	let response = [];
-	const options = [{
+	const options = [];
+	if (isExampleTodoAllowed(backend, database)) options.push({
 		value: "todo",
 		label: "Todo App",
 		hint: "A simple CRUD example app"
-	}];
-	if (backend !== "elysia" && !frontends?.includes("solid")) options.push({
+	});
+	if (isExampleAIAllowed(backend, frontends ?? [])) options.push({
 		value: "ai",
 		label: "AI Chat",
 		hint: "A simple AI chat interface using AI SDK"
 	});
+	if (options.length === 0) return [];
 	response = await multiselect({
 		message: "Include examples",
 		options,
 		required: false,
-		initialValues: DEFAULT_CONFIG.examples
+		initialValues: DEFAULT_CONFIG.examples?.filter((ex) => options.some((o) => o.value === ex))
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -711,10 +807,7 @@ async function getFrontendChoice(frontendOptions, backend) {
 		required: false,
 		initialValues: ["web"]
 	});
-	if (isCancel(frontendTypes)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(frontendTypes)) return exitCancelled("Operation cancelled");
 	const result = [];
 	if (frontendTypes.includes("web")) {
 		const allWebOptions = [
@@ -750,23 +843,17 @@ async function getFrontendChoice(frontendOptions, backend) {
 			},
 			{
 				value: "tanstack-start",
-				label: "TanStack Start (vite)",
+				label: "TanStack Start",
 				hint: "SSR, Server Functions, API Routes and more with TanStack Router"
 			}
 		];
-		const webOptions = allWebOptions.filter((option) => {
-			if (backend === "convex") return option.value !== "solid";
-			return true;
-		});
+		const webOptions = allWebOptions.filter((option) => isFrontendAllowedWithBackend(option.value, backend));
 		const webFramework = await select({
 			message: "Choose web",
 			options: webOptions,
 			initialValue: DEFAULT_CONFIG.frontend[0]
 		});
-		if (isCancel(webFramework)) {
-			cancel(pc.red("Operation cancelled"));
-			process.exit(0);
-		}
+		if (isCancel(webFramework)) return exitCancelled("Operation cancelled");
 		result.push(webFramework);
 	}
 	if (frontendTypes.includes("native")) {
@@ -783,10 +870,7 @@ async function getFrontendChoice(frontendOptions, backend) {
 			}],
 			initialValue: "native-nativewind"
 		});
-		if (isCancel(nativeFramework)) {
-			cancel(pc.red("Operation cancelled"));
-			process.exit(0);
-		}
+		if (isCancel(nativeFramework)) return exitCancelled("Operation cancelled");
 		result.push(nativeFramework);
 	}
 	return result;
@@ -800,10 +884,7 @@ async function getGitChoice(git) {
 		message: "Initialize git repository?",
 		initialValue: DEFAULT_CONFIG.git
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -815,10 +896,7 @@ async function getinstallChoice(install) {
 		message: "Install dependencies?",
 		initialValue: DEFAULT_CONFIG.install
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -852,10 +930,7 @@ async function getORMChoice(orm, hasDatabase, database, backend, runtime) {
 		options,
 		initialValue: database === "mongodb" ? "prisma" : DEFAULT_CONFIG.orm
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -885,10 +960,7 @@ async function getPackageManagerChoice(packageManager) {
 		],
 		initialValue: detectedPackageManager
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -917,10 +989,7 @@ async function getRuntimeChoice(runtime, backend) {
 		options: runtimeOptions,
 		initialValue: DEFAULT_CONFIG.runtime
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -956,10 +1025,7 @@ async function getDeploymentChoice(deployment, _runtime, _backend, frontend = []
 		options,
 		initialValue: DEFAULT_CONFIG.webDeploy
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 async function getDeploymentToAdd(frontend, existingDeployment) {
@@ -985,10 +1051,7 @@ async function getDeploymentToAdd(frontend, existingDeployment) {
 		options,
 		initialValue: DEFAULT_CONFIG.webDeploy
 	});
-	if (isCancel(response)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(response)) return exitCancelled("Operation cancelled");
 	return response;
 }
 
@@ -1010,10 +1073,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		git: () => getGitChoice(flags.git),
 		packageManager: () => getPackageManagerChoice(flags.packageManager),
 		install: () => getinstallChoice(flags.install)
-	}, { onCancel: () => {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	} });
+	}, { onCancel: () => exitCancelled("Operation cancelled") });
 	if (result.backend === "convex") {
 		result.runtime = "none";
 		result.database = "none";
@@ -1057,6 +1117,11 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 
 //#endregion
 //#region src/prompts/project-name.ts
+function isPathWithinCwd(targetPath) {
+	const resolved = path.resolve(targetPath);
+	const rel = path.relative(process.cwd(), resolved);
+	return !rel.startsWith("..") && !path.isAbsolute(rel);
+}
 function validateDirectoryName(name) {
 	if (name === ".") return void 0;
 	const result = ProjectNameSchema.safeParse(name);
@@ -1068,7 +1133,11 @@ async function getProjectName(initialName) {
 		if (initialName === ".") return initialName;
 		const finalDirName = path.basename(initialName);
 		const validationError = validateDirectoryName(finalDirName);
-		if (!validationError) return initialName;
+		if (!validationError) {
+			const projectDir = path.resolve(process.cwd(), initialName);
+			if (isPathWithinCwd(projectDir)) return initialName;
+			consola.error(pc.red("Project path must be within current directory"));
+		}
 	}
 	let isValid = false;
 	let projectPath = "";
@@ -1091,15 +1160,12 @@ async function getProjectName(initialName) {
 				if (validationError) return validationError;
 				if (nameToUse !== ".") {
 					const projectDir = path.resolve(process.cwd(), nameToUse);
-					if (!projectDir.startsWith(process.cwd())) return "Project path must be within current directory";
+					if (!isPathWithinCwd(projectDir)) return "Project path must be within current directory";
 				}
 				return void 0;
 			}
 		});
-		if (isCancel(response)) {
-			cancel(pc.red("Operation cancelled."));
-			process.exit(0);
-		}
+		if (isCancel(response)) return exitCancelled("Operation cancelled.");
 		projectPath = response || defaultName;
 		isValid = true;
 	}
@@ -1224,11 +1290,11 @@ function generateReproducibleCommand(config) {
 	flags.push(config.git ? "--git" : "--no-git");
 	flags.push(`--package-manager ${config.packageManager}`);
 	flags.push(config.install ? "--install" : "--no-install");
-	let baseCommand = "";
+	let baseCommand = "npx create-better-t-stack@latest";
 	const pkgManager = config.packageManager;
-	if (pkgManager === "npm") baseCommand = "npx create-better-t-stack@latest";
+	if (pkgManager === "bun") baseCommand = "bun create better-t-stack@latest";
 	else if (pkgManager === "pnpm") baseCommand = "pnpm create better-t-stack@latest";
-	else if (pkgManager === "bun") baseCommand = "bun create better-t-stack@latest";
+	else if (pkgManager === "npm") baseCommand = "npx create-better-t-stack@latest";
 	const projectPathArg = config.relativePath ? ` ${config.relativePath}` : "";
 	return `${baseCommand}${projectPathArg} ${flags.join(" ")}`;
 }
@@ -1271,10 +1337,7 @@ async function handleDirectoryConflict(currentPathInput) {
 			],
 			initialValue: "rename"
 		});
-		if (isCancel(action)) {
-			cancel(pc.red("Operation cancelled."));
-			process.exit(0);
-		}
+		if (isCancel(action)) return exitCancelled("Operation cancelled.");
 		switch (action) {
 			case "overwrite": return {
 				finalPathInput: currentPathInput,
@@ -1291,9 +1354,7 @@ async function handleDirectoryConflict(currentPathInput) {
 				const newPathInput = await getProjectName(void 0);
 				return await handleDirectoryConflict(newPathInput);
 			}
-			case "cancel":
-				cancel(pc.red("Operation cancelled."));
-				process.exit(0);
+			case "cancel": return exitCancelled("Operation cancelled.");
 		}
 	}
 }
@@ -1315,8 +1376,7 @@ async function setupProjectDirectory(finalPathInput, shouldClearDirectory) {
 			s.stop(`Directory "${finalResolvedPath}" cleared.`);
 		} catch (error) {
 			s.stop(pc.red(`Failed to clear directory "${finalResolvedPath}".`));
-			consola$1.error(error);
-			process.exit(1);
+			handleError(error);
 		}
 	} else await fs.ensureDir(finalResolvedPath);
 	return {
@@ -1376,18 +1436,12 @@ function processAndValidateFlags(options, providedFlags, projectName) {
 	if (options.api) {
 		config.api = options.api;
 		if (options.api === "none") {
-			if (options.examples && !(options.examples.length === 1 && options.examples[0] === "none") && options.backend !== "convex") {
-				consola$1.fatal("Cannot use '--examples' when '--api' is set to 'none'. Please remove the --examples flag or choose an API type.");
-				process.exit(1);
-			}
+			if (options.examples && !(options.examples.length === 1 && options.examples[0] === "none") && options.backend !== "convex") exitWithError("Cannot use '--examples' when '--api' is set to 'none'. Please remove the --examples flag or choose an API type.");
 		}
 	}
 	if (options.backend) config.backend = options.backend;
 	if (providedFlags.has("backend") && config.backend && config.backend !== "convex" && config.backend !== "none") {
-		if (providedFlags.has("runtime") && options.runtime === "none") {
-			consola$1.fatal(`'--runtime none' is only supported with '--backend convex' or '--backend none'. Please choose 'bun', 'node', or remove the --runtime flag.`);
-			process.exit(1);
-		}
+		if (providedFlags.has("runtime") && options.runtime === "none") exitWithError(`'--runtime none' is only supported with '--backend convex' or '--backend none'. Please choose 'bun', 'node', or remove the --runtime flag.`);
 	}
 	if (options.database) config.database = options.database;
 	if (options.orm) config.orm = options.orm;
@@ -1400,210 +1454,68 @@ function processAndValidateFlags(options, providedFlags, projectName) {
 	if (options.webDeploy) config.webDeploy = options.webDeploy;
 	if (projectName) {
 		const result = ProjectNameSchema.safeParse(path.basename(projectName));
-		if (!result.success) {
-			consola$1.fatal(`Invalid project name: ${result.error.issues[0]?.message || "Invalid project name"}`);
-			process.exit(1);
-		}
+		if (!result.success) exitWithError(`Invalid project name: ${result.error.issues[0]?.message || "Invalid project name"}`);
 		config.projectName = projectName;
 	} else if (options.projectDirectory) {
 		const baseName = path.basename(path.resolve(process.cwd(), options.projectDirectory));
 		const result = ProjectNameSchema.safeParse(baseName);
-		if (!result.success) {
-			consola$1.fatal(`Invalid project name: ${result.error.issues[0]?.message || "Invalid project name"}`);
-			process.exit(1);
-		}
+		if (!result.success) exitWithError(`Invalid project name: ${result.error.issues[0]?.message || "Invalid project name"}`);
 		config.projectName = baseName;
 	}
 	if (options.frontend && options.frontend.length > 0) if (options.frontend.includes("none")) {
-		if (options.frontend.length > 1) {
-			consola$1.fatal(`Cannot combine 'none' with other frontend options.`);
-			process.exit(1);
-		}
+		if (options.frontend.length > 1) exitWithError(`Cannot combine 'none' with other frontend options.`);
 		config.frontend = [];
 	} else {
 		const validOptions = options.frontend.filter((f) => f !== "none");
-		const webFrontends = validOptions.filter((f) => WEB_FRAMEWORKS.includes(f));
-		const nativeFrontends = validOptions.filter((f) => f === "native-nativewind" || f === "native-unistyles");
-		if (webFrontends.length > 1) {
-			consola$1.fatal("Cannot select multiple web frameworks. Choose only one of: tanstack-router, tanstack-start, react-router, next, nuxt, svelte, solid");
-			process.exit(1);
-		}
-		if (nativeFrontends.length > 1) {
-			consola$1.fatal("Cannot select multiple native frameworks. Choose only one of: native-nativewind, native-unistyles");
-			process.exit(1);
-		}
+		ensureSingleWebAndNative(validOptions);
 		config.frontend = validOptions;
 	}
+	if (providedFlags.has("api") && providedFlags.has("frontend") && config.api && config.frontend && config.frontend.length > 0) validateApiFrontendCompatibility(config.api, config.frontend);
 	if (options.addons && options.addons.length > 0) if (options.addons.includes("none")) {
-		if (options.addons.length > 1) {
-			consola$1.fatal(`Cannot combine 'none' with other addons.`);
-			process.exit(1);
-		}
+		if (options.addons.length > 1) exitWithError(`Cannot combine 'none' with other addons.`);
 		config.addons = [];
 	} else config.addons = options.addons.filter((addon) => addon !== "none");
 	if (options.examples && options.examples.length > 0) if (options.examples.includes("none")) {
-		if (options.examples.length > 1) {
-			consola$1.fatal("Cannot combine 'none' with other examples.");
-			process.exit(1);
-		}
+		if (options.examples.length > 1) exitWithError("Cannot combine 'none' with other examples.");
 		config.examples = [];
 	} else {
 		config.examples = options.examples.filter((ex) => ex !== "none");
 		if (options.examples.includes("none") && config.backend !== "convex") config.examples = [];
 	}
-	if (config.backend === "convex") {
-		const incompatibleFlags = [];
-		if (providedFlags.has("auth") && options.auth === true) incompatibleFlags.push("--auth");
-		if (providedFlags.has("database") && options.database !== "none") incompatibleFlags.push(`--database ${options.database}`);
-		if (providedFlags.has("orm") && options.orm !== "none") incompatibleFlags.push(`--orm ${options.orm}`);
-		if (providedFlags.has("api") && options.api !== "none") incompatibleFlags.push(`--api ${options.api}`);
-		if (providedFlags.has("runtime") && options.runtime !== "none") incompatibleFlags.push(`--runtime ${options.runtime}`);
-		if (providedFlags.has("dbSetup") && options.dbSetup !== "none") incompatibleFlags.push(`--db-setup ${options.dbSetup}`);
-		if (incompatibleFlags.length > 0) {
-			consola$1.fatal(`The following flags are incompatible with '--backend convex': ${incompatibleFlags.join(", ")}. Please remove them.`);
-			process.exit(1);
-		}
-		if (providedFlags.has("frontend") && options.frontend) {
+	if (config.backend === "convex" || config.backend === "none") {
+		const incompatibleFlags = incompatibleFlagsForBackend(config.backend, providedFlags, options);
+		if (incompatibleFlags.length > 0) exitWithError(`The following flags are incompatible with '--backend ${config.backend}': ${incompatibleFlags.join(", ")}. Please remove them.`);
+		if (config.backend === "convex" && providedFlags.has("frontend") && options.frontend) {
 			const incompatibleFrontends = options.frontend.filter((f) => f === "solid");
-			if (incompatibleFrontends.length > 0) {
-				consola$1.fatal(`The following frontends are not compatible with '--backend convex': ${incompatibleFrontends.join(", ")}. Please choose a different frontend or backend.`);
-				process.exit(1);
-			}
+			if (incompatibleFrontends.length > 0) exitWithError(`The following frontends are not compatible with '--backend convex': ${incompatibleFrontends.join(", ")}. Please choose a different frontend or backend.`);
 		}
-		config.auth = false;
-		config.database = "none";
-		config.orm = "none";
-		config.api = "none";
-		config.runtime = "none";
-		config.dbSetup = "none";
-		config.examples = ["todo"];
-	} else if (config.backend === "none") {
-		const incompatibleFlags = [];
-		if (providedFlags.has("auth") && options.auth === true) incompatibleFlags.push("--auth");
-		if (providedFlags.has("database") && options.database !== "none") incompatibleFlags.push(`--database ${options.database}`);
-		if (providedFlags.has("orm") && options.orm !== "none") incompatibleFlags.push(`--orm ${options.orm}`);
-		if (providedFlags.has("api") && options.api !== "none") incompatibleFlags.push(`--api ${options.api}`);
-		if (providedFlags.has("runtime") && options.runtime !== "none") incompatibleFlags.push(`--runtime ${options.runtime}`);
-		if (providedFlags.has("dbSetup") && options.dbSetup !== "none") incompatibleFlags.push(`--db-setup ${options.dbSetup}`);
-		if (providedFlags.has("examples") && options.examples) {
-			const hasNonNoneExamples = options.examples.some((ex) => ex !== "none");
-			if (hasNonNoneExamples) incompatibleFlags.push("--examples");
-		}
-		if (incompatibleFlags.length > 0) {
-			consola$1.fatal(`The following flags are incompatible with '--backend none': ${incompatibleFlags.join(", ")}. Please remove them.`);
-			process.exit(1);
-		}
-		config.auth = false;
-		config.database = "none";
-		config.orm = "none";
-		config.api = "none";
-		config.runtime = "none";
-		config.dbSetup = "none";
-		config.examples = [];
-	}
-	if (config.orm === "mongoose" && config.database !== "mongodb") {
-		consola$1.fatal("Mongoose ORM requires MongoDB database. Please use '--database mongodb' or choose a different ORM.");
-		process.exit(1);
-	}
-	if (config.database === "mongodb" && config.orm && config.orm !== "mongoose" && config.orm !== "prisma") {
-		consola$1.fatal("MongoDB database requires Mongoose or Prisma ORM. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
-		process.exit(1);
-	}
-	if (config.orm === "drizzle" && config.database === "mongodb") {
-		consola$1.fatal("Drizzle ORM does not support MongoDB. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
-		process.exit(1);
-	}
-	if (config.database && config.database !== "none" && config.orm === "none") {
-		consola$1.fatal("Database selection requires an ORM. Please choose '--orm drizzle', '--orm prisma', or '--orm mongoose'.");
-		process.exit(1);
-	}
-	if (config.orm && config.orm !== "none" && config.database === "none") {
-		consola$1.fatal("ORM selection requires a database. Please choose a database or set '--orm none'.");
-		process.exit(1);
-	}
-	if (config.auth && config.database === "none") {
-		consola$1.fatal("Authentication requires a database. Please choose a database or set '--no-auth'.");
-		process.exit(1);
-	}
-	if (config.dbSetup && config.dbSetup !== "none" && config.database === "none") {
-		consola$1.fatal("Database setup requires a database. Please choose a database or set '--db-setup none'.");
-		process.exit(1);
-	}
-	if (config.dbSetup === "turso" && config.database !== "sqlite") {
-		consola$1.fatal("Turso setup requires SQLite database. Please use '--database sqlite' or choose a different setup.");
-		process.exit(1);
-	}
-	if (config.dbSetup === "neon" && config.database !== "postgres") {
-		consola$1.fatal("Neon setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.");
-		process.exit(1);
-	}
-	if (config.dbSetup === "prisma-postgres" && config.database !== "postgres") {
-		consola$1.fatal("Prisma PostgreSQL setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.");
-		process.exit(1);
-	}
-	if (config.dbSetup === "mongodb-atlas" && config.database !== "mongodb") {
-		consola$1.fatal("MongoDB Atlas setup requires MongoDB database. Please use '--database mongodb' or choose a different setup.");
-		process.exit(1);
-	}
-	if (config.dbSetup === "supabase" && config.database !== "postgres") {
-		consola$1.fatal("Supabase setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.");
-		process.exit(1);
-	}
+		coerceBackendPresets(config);
+	}
+	if (providedFlags.has("orm") && providedFlags.has("database") && config.orm === "mongoose" && config.database !== "mongodb") exitWithError("Mongoose ORM requires MongoDB database. Please use '--database mongodb' or choose a different ORM.");
+	if (providedFlags.has("database") && providedFlags.has("orm") && config.database === "mongodb" && config.orm && config.orm !== "mongoose" && config.orm !== "prisma") exitWithError("MongoDB database requires Mongoose or Prisma ORM. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
+	if (providedFlags.has("orm") && providedFlags.has("database") && config.orm === "drizzle" && config.database === "mongodb") exitWithError("Drizzle ORM does not support MongoDB. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
+	if (providedFlags.has("database") && providedFlags.has("orm") && config.database && config.database !== "none" && config.orm === "none") exitWithError("Database selection requires an ORM. Please choose '--orm drizzle', '--orm prisma', or '--orm mongoose'.");
+	if (providedFlags.has("orm") && providedFlags.has("database") && config.orm && config.orm !== "none" && config.database === "none") exitWithError("ORM selection requires a database. Please choose a database or set '--orm none'.");
+	if (providedFlags.has("auth") && providedFlags.has("database") && config.auth && config.database === "none") exitWithError("Authentication requires a database. Please choose a database or set '--no-auth'.");
+	if (providedFlags.has("dbSetup") && providedFlags.has("database") && config.dbSetup && config.dbSetup !== "none" && config.database === "none") exitWithError("Database setup requires a database. Please choose a database or set '--db-setup none'.");
+	if (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && config.dbSetup === "turso" && config.database !== "sqlite") exitWithError("Turso setup requires SQLite database. Please use '--database sqlite' or choose a different setup.");
+	if (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && config.dbSetup === "neon" && config.database !== "postgres") exitWithError("Neon setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.");
+	if (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && config.dbSetup === "prisma-postgres" && config.database !== "postgres") exitWithError("Prisma PostgreSQL setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.");
+	if (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && config.dbSetup === "mongodb-atlas" && config.database !== "mongodb") exitWithError("MongoDB Atlas setup requires MongoDB database. Please use '--database mongodb' or choose a different setup.");
+	if (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && config.dbSetup === "supabase" && config.database !== "postgres") exitWithError("Supabase setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup.");
 	if (config.dbSetup === "d1") {
-		if (config.database !== "sqlite") {
-			consola$1.fatal("Cloudflare D1 setup requires SQLite database. Please use '--database sqlite' or choose a different setup.");
-			process.exit(1);
+		if (providedFlags.has("dbSetup") && providedFlags.has("database") || providedFlags.has("dbSetup") && !config.database) {
+			if (config.database !== "sqlite") exitWithError("Cloudflare D1 setup requires SQLite database. Please use '--database sqlite' or choose a different setup.");
 		}
-		if (config.runtime !== "workers") {
-			consola$1.fatal("Cloudflare D1 setup requires the Cloudflare Workers runtime. Please use '--runtime workers' or choose a different setup.");
-			process.exit(1);
+		if (providedFlags.has("dbSetup") && providedFlags.has("runtime") || providedFlags.has("dbSetup") && !config.runtime) {
+			if (config.runtime !== "workers") exitWithError("Cloudflare D1 setup requires the Cloudflare Workers runtime. Please use '--runtime workers' or choose a different setup.");
 		}
 	}
-	if (config.dbSetup === "docker" && config.database === "sqlite") {
-		consola$1.fatal("Docker setup is not compatible with SQLite database. SQLite is file-based and doesn't require Docker. Please use '--database postgres', '--database mysql', '--database mongodb', or choose a different setup.");
-		process.exit(1);
-	}
-	if (config.dbSetup === "docker" && config.runtime === "workers") {
-		consola$1.fatal("Docker setup is not compatible with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
-		process.exit(1);
-	}
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && config.backend !== "hono") {
-		consola$1.fatal(`Cloudflare Workers runtime (--runtime workers) is only supported with Hono backend (--backend hono). Current backend: ${config.backend}. Please use '--backend hono' or choose a different runtime.`);
-		process.exit(1);
-	}
-	if (providedFlags.has("backend") && config.backend && config.backend !== "hono" && config.runtime === "workers") {
-		consola$1.fatal(`Backend '${config.backend}' is not compatible with Cloudflare Workers runtime. Cloudflare Workers runtime is only supported with Hono backend. Please use '--backend hono' or choose a different runtime.`);
-		process.exit(1);
-	}
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.orm && config.orm !== "drizzle" && config.orm !== "none") {
-		consola$1.fatal(`Cloudflare Workers runtime (--runtime workers) is only supported with Drizzle ORM (--orm drizzle) or no ORM (--orm none). Current ORM: ${config.orm}. Please use '--orm drizzle', '--orm none', or choose a different runtime.`);
-		process.exit(1);
-	}
-	if (providedFlags.has("orm") && config.orm && config.orm !== "drizzle" && config.orm !== "none" && config.runtime === "workers") {
-		consola$1.fatal(`ORM '${config.orm}' is not compatible with Cloudflare Workers runtime. Cloudflare Workers runtime is only supported with Drizzle ORM or no ORM. Please use '--orm drizzle', '--orm none', or choose a different runtime.`);
-		process.exit(1);
-	}
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.database === "mongodb") {
-		consola$1.fatal("Cloudflare Workers runtime (--runtime workers) is not compatible with MongoDB database. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle ORM. Please use a different database or runtime.");
-		process.exit(1);
-	}
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.dbSetup === "docker") {
-		consola$1.fatal("Cloudflare Workers runtime (--runtime workers) is not compatible with Docker setup. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
-		process.exit(1);
-	}
-	if (providedFlags.has("database") && config.database === "mongodb" && config.runtime === "workers") {
-		consola$1.fatal("MongoDB database is not compatible with Cloudflare Workers runtime. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle ORM. Please use a different database or runtime.");
-		process.exit(1);
-	}
-	if (providedFlags.has("db-setup") && options.dbSetup === "docker" && config.runtime === "workers") {
-		consola$1.fatal("Docker setup (--db-setup docker) is not compatible with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
-		process.exit(1);
-	}
-	const hasWebFrontendFlag = (config.frontend ?? []).some((f) => WEB_FRAMEWORKS.includes(f));
-	if (config.webDeploy && config.webDeploy !== "none" && !hasWebFrontendFlag && providedFlags.has("frontend")) {
-		consola$1.fatal("'--web-deploy' requires a web frontend. Please select a web frontend or set '--web-deploy none'.");
-		process.exit(1);
-	}
+	if (providedFlags.has("dbSetup") && providedFlags.has("database") && config.dbSetup === "docker" && config.database === "sqlite") exitWithError("Docker setup is not compatible with SQLite database. SQLite is file-based and doesn't require Docker. Please use '--database postgres', '--database mysql', '--database mongodb', or choose a different setup.");
+	if (providedFlags.has("dbSetup") && providedFlags.has("runtime") && config.dbSetup === "docker" && config.runtime === "workers") exitWithError("Docker setup is not compatible with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
+	validateWorkersCompatibility(providedFlags, options, config);
+	const hasWebFrontendFlag = (config.frontend ?? []).some((f) => isWebFrontend(f));
+	validateWebDeployRequiresWebFrontend(config.webDeploy, hasWebFrontendFlag);
 	return config;
 }
 function getProvidedFlags(options) {
@@ -1774,12 +1686,9 @@ async function setupFumadocs(config) {
 			})),
 			initialValue: "next-mdx"
 		});
-		if (isCancel(template)) {
-			cancel(pc.red("Operation cancelled"));
-			process.exit(0);
-		}
+		if (isCancel(template)) return exitCancelled("Operation cancelled");
 		const templateArg = TEMPLATES[template].value;
-		const commandWithArgs = `create-fumadocs-app@latest fumadocs --template ${templateArg} --src --no-install --pm ${packageManager} --no-eslint`;
+		const commandWithArgs = `create-fumadocs-app@latest fumadocs --template ${templateArg} --src --no-install --pm ${packageManager} --no-eslint --no-git`;
 		const fumadocsInitCommand = getPackageExecutionCommand(packageManager, commandWithArgs);
 		await execa(fumadocsInitCommand, {
 			cwd: path.join(projectDir, "apps"),
@@ -1941,10 +1850,7 @@ async function setupUltracite(config, hasHusky) {
 			})),
 			required: false
 		});
-		if (isCancel(editors)) {
-			cancel(pc.red("Operation cancelled"));
-			process.exit(0);
-		}
+		if (isCancel(editors)) return exitCancelled("Operation cancelled");
 		const rules = await multiselect({
 			message: "Choose rules",
 			options: Object.entries(RULES).map(([key, rule]) => ({
@@ -1954,10 +1860,7 @@ async function setupUltracite(config, hasHusky) {
 			})),
 			required: false
 		});
-		if (isCancel(rules)) {
-			cancel(pc.red("Operation cancelled"));
-			process.exit(0);
-		}
+		if (isCancel(rules)) return exitCancelled("Operation cancelled");
 		const ultraciteArgs = [
 			"init",
 			"--pm",
@@ -1989,6 +1892,135 @@ async function setupUltracite(config, hasHusky) {
 	}
 }
 
+//#endregion
+//#region src/utils/template-processor.ts
+/**
+* Processes a Handlebars template file and writes the output to the destination.
+* @param srcPath Path to the source .hbs template file.
+* @param destPath Path to write the processed file.
+* @param context Data to be passed to the Handlebars template.
+*/
+async function processTemplate(srcPath, destPath, context) {
+	try {
+		const templateContent = await fs.readFile(srcPath, "utf-8");
+		const template = handlebars.compile(templateContent);
+		const processedContent = template(context);
+		await fs.ensureDir(path.dirname(destPath));
+		await fs.writeFile(destPath, processedContent);
+	} catch (error) {
+		consola.error(`Error processing template ${srcPath}:`, error);
+		throw new Error(`Failed to process template ${srcPath}`);
+	}
+}
+handlebars.registerHelper("eq", (a, b) => a === b);
+handlebars.registerHelper("ne", (a, b) => a !== b);
+handlebars.registerHelper("and", (a, b) => a && b);
+handlebars.registerHelper("or", (a, b) => a || b);
+handlebars.registerHelper("includes", (array, value) => Array.isArray(array) && array.includes(value));
+
+//#endregion
+//#region src/helpers/setup/vibe-rules-setup.ts
+async function setupVibeRules(config) {
+	const { packageManager, projectDir } = config;
+	try {
+		log.info("Setting up vibe-rules...");
+		const rulesDir = path.join(projectDir, ".bts");
+		const ruleFile = path.join(rulesDir, "rules.md");
+		if (!await fs.pathExists(ruleFile)) {
+			const templatePath = path.join(PKG_ROOT, "templates", "addons", "vibe-rules", ".bts", "rules.md.hbs");
+			if (await fs.pathExists(templatePath)) {
+				await fs.ensureDir(rulesDir);
+				await processTemplate(templatePath, ruleFile, config);
+			} else {
+				log.error(pc.red("Rules template not found for vibe-rules addon"));
+				return;
+			}
+		}
+		const EDITORS$1 = {
+			cursor: {
+				label: "Cursor",
+				hint: ".cursor/rules/*.mdc"
+			},
+			windsurf: {
+				label: "Windsurf",
+				hint: ".windsurfrules"
+			},
+			"claude-code": {
+				label: "Claude Code",
+				hint: "CLAUDE.md"
+			},
+			vscode: {
+				label: "VSCode",
+				hint: ".github/instructions/*.instructions.md"
+			},
+			gemini: {
+				label: "Gemini",
+				hint: "GEMINI.md"
+			},
+			codex: {
+				label: "Codex",
+				hint: "AGENTS.md"
+			},
+			clinerules: {
+				label: "Cline/Roo",
+				hint: ".clinerules/*.md"
+			},
+			roo: {
+				label: "Roo",
+				hint: ".clinerules/*.md"
+			},
+			zed: {
+				label: "Zed",
+				hint: ".rules/*.md"
+			},
+			unified: {
+				label: "Unified",
+				hint: ".rules/*.md"
+			}
+		};
+		const selectedEditors = await multiselect({
+			message: "Choose editors to install BTS rule",
+			options: Object.entries(EDITORS$1).map(([key, v]) => ({
+				value: key,
+				label: v.label,
+				hint: v.hint
+			})),
+			required: false
+		});
+		if (isCancel(selectedEditors)) return exitCancelled("Operation cancelled");
+		const editorsArg = selectedEditors.join(", ");
+		const s = spinner();
+		s.start("Saving and applying BTS rules...");
+		try {
+			const saveCmd = getPackageExecutionCommand(packageManager, `vibe-rules@latest save bts -f ${JSON.stringify(path.relative(projectDir, ruleFile))}`);
+			await execa(saveCmd, {
+				cwd: projectDir,
+				env: { CI: "true" },
+				shell: true
+			});
+			for (const editor of selectedEditors) {
+				const loadCmd = getPackageExecutionCommand(packageManager, `vibe-rules@latest load bts ${editor}`);
+				await execa(loadCmd, {
+					cwd: projectDir,
+					env: { CI: "true" },
+					shell: true
+				});
+			}
+			s.stop(`Applied BTS rules to: ${editorsArg}`);
+		} catch (error) {
+			s.stop(pc.red("Failed to apply BTS rules"));
+			throw error;
+		}
+		try {
+			await fs.remove(rulesDir);
+		} catch (_) {}
+		log.success("vibe-rules setup successfully!");
+	} catch (error) {
+		log.error(pc.red("Failed to set up vibe-rules"));
+		if (error instanceof Error) console.error(pc.red(error.message));
+	}
+}
+
 //#endregion
 //#region src/utils/ts-morph.ts
 const tsProject = new Project({
@@ -2080,6 +2112,7 @@ ${pc.cyan("Docs:")} ${pc.underline("https://turborepo.com/docs")}
 	}
 	if (addons.includes("oxlint")) await setupOxlint(projectDir, packageManager);
 	if (addons.includes("starlight")) await setupStarlight(config);
+	if (addons.includes("vibe-rules")) await setupVibeRules(config);
 	if (addons.includes("fumadocs")) await setupFumadocs(config);
 }
 function getWebAppDir(projectDir, frontends) {
@@ -2224,31 +2257,6 @@ async function installDependencies({ projectDir, packageManager }) {
 	}
 }
 
-//#endregion
-//#region src/utils/template-processor.ts
-/**
-* Processes a Handlebars template file and writes the output to the destination.
-* @param srcPath Path to the source .hbs template file.
-* @param destPath Path to write the processed file.
-* @param context Data to be passed to the Handlebars template.
-*/
-async function processTemplate(srcPath, destPath, context) {
-	try {
-		const templateContent = await fs.readFile(srcPath, "utf-8");
-		const template = handlebars.compile(templateContent);
-		const processedContent = template(context);
-		await fs.ensureDir(path.dirname(destPath));
-		await fs.writeFile(destPath, processedContent);
-	} catch (error) {
-		consola.error(`Error processing template ${srcPath}:`, error);
-		throw new Error(`Failed to process template ${srcPath}`);
-	}
-}
-handlebars.registerHelper("eq", (a, b) => a === b);
-handlebars.registerHelper("and", (a, b) => a && b);
-handlebars.registerHelper("or", (a, b) => a || b);
-handlebars.registerHelper("includes", (array, value) => Array.isArray(array) && array.includes(value));
-
 //#endregion
 //#region src/helpers/project-generation/template-manager.ts
 async function processAndCopyFiles(sourcePattern, baseSourceDir, destDir, context, overwrite = true) {
@@ -2459,6 +2467,7 @@ async function setupAddonsTemplate(projectDir, context) {
 	if (!context.addons || context.addons.length === 0) return;
 	for (const addon of context.addons) {
 		if (addon === "none") continue;
+		if (addon === "vibe-rules") continue;
 		let addonSrcDir = path.join(PKG_ROOT, `templates/addons/${addon}`);
 		let addonDestDir = projectDir;
 		if (addon === "pwa") {
@@ -2619,17 +2628,13 @@ async function setupDeploymentTemplates(projectDir, context) {
 
 //#endregion
 //#region src/helpers/project-generation/add-addons.ts
-function exitWithError$1(message) {
-	cancel(pc.red(message));
-	process.exit(1);
-}
 async function addAddonsToProject(input) {
 	try {
 		const projectDir = input.projectDir || process.cwd();
 		const isBetterTStack = await isBetterTStackProject(projectDir);
-		if (!isBetterTStack) exitWithError$1("This doesn't appear to be a Better-T Stack project. Please run this command from the root of a Better-T Stack project.");
+		if (!isBetterTStack) exitWithError("This doesn't appear to be a Better-T Stack project. Please run this command from the root of a Better-T Stack project.");
 		const detectedConfig = await detectProjectConfig(projectDir);
-		if (!detectedConfig) exitWithError$1("Could not detect the project configuration. Please ensure this is a valid Better-T Stack project.");
+		if (!detectedConfig) exitWithError("Could not detect the project configuration. Please ensure this is a valid Better-T Stack project.");
 		const config = {
 			projectName: detectedConfig.projectName || path.basename(projectDir),
 			projectDir,
@@ -2651,9 +2656,8 @@ async function addAddonsToProject(input) {
 		};
 		for (const addon of input.addons) {
 			const { isCompatible, reason } = validateAddonCompatibility(addon, config.frontend);
-			if (!isCompatible) exitWithError$1(reason || `${addon} addon is not compatible with current frontend configuration`);
+			if (!isCompatible) exitWithError(reason || `${addon} addon is not compatible with current frontend configuration`);
 		}
-		log.info(`Adding ${input.addons.join(", ")} to ${config.frontend.join("/")}`);
 		await setupAddonsTemplate(projectDir, config);
 		await setupAddons(config, true);
 		const currentAddons = detectedConfig.addons || [];
@@ -2666,7 +2670,7 @@ async function addAddonsToProject(input) {
 		else if (!input.suppressInstallMessage) log.info(pc.yellow(`Run ${pc.bold(`${config.packageManager} install`)} to install dependencies`));
 	} catch (error) {
 		const message = error instanceof Error ? error.message : String(error);
-		exitWithError$1(`Error adding addons: ${message}`);
+		exitWithError(`Error adding addons: ${message}`);
 	}
 }
 
@@ -2899,10 +2903,6 @@ async function setupNextWorkersDeploy(projectDir, _packageManager) {
 
 //#endregion
 //#region src/helpers/project-generation/add-deployment.ts
-function exitWithError(message) {
-	cancel(pc.red(message));
-	process.exit(1);
-}
 async function addDeploymentToProject(input) {
 	try {
 		const projectDir = input.projectDir || process.cwd();
@@ -3702,10 +3702,7 @@ async function setupNeonPostgres(config) {
 			}],
 			initialValue: "neondb"
 		});
-		if (isCancel(setupMethod)) {
-			cancel(pc.red("Operation cancelled"));
-			process.exit(0);
-		}
+		if (isCancel(setupMethod)) return exitCancelled("Operation cancelled");
 		if (setupMethod === "neondb") await setupWithNeonDb(projectDir, packageManager);
 		else {
 			const suggestedProjectName = path.basename(projectDir);
@@ -3719,10 +3716,7 @@ async function setupNeonPostgres(config) {
 				options: NEON_REGIONS,
 				initialValue: NEON_REGIONS[0].value
 			});
-			if (isCancel(projectName) || isCancel(regionId)) {
-				cancel(pc.red("Operation cancelled"));
-				process.exit(0);
-			}
+			if (isCancel(projectName) || isCancel(regionId)) return exitCancelled("Operation cancelled");
 			const neonConfig = await createNeonProject(projectName, regionId, packageManager);
 			if (!neonConfig) throw new Error("Failed to create project - couldn't get connection information");
 			const finalSpinner = spinner();
@@ -3757,10 +3751,7 @@ async function setupWithCreateDb(serverDir, packageManager, orm) {
 				if (orm === "drizzle" && !value.includes("?sslmode=require")) return "Please append ?sslmode=require to your database URL when using Drizzle";
 			}
 		});
-		if (isCancel(databaseUrl)) {
-			cancel("Database setup cancelled");
-			return null;
-		}
+		if (isCancel(databaseUrl)) return null;
 		return { databaseUrl };
 	} catch (error) {
 		if (error instanceof Error) consola$1.error(error.message);
@@ -3786,10 +3777,7 @@ async function initPrismaDatabase(serverDir, packageManager) {
 				if (!value.startsWith("prisma+postgres://")) return "URL should start with prisma+postgres://";
 			}
 		});
-		if (isCancel(databaseUrl)) {
-			cancel("Database setup cancelled");
-			return null;
-		}
+		if (isCancel(databaseUrl)) return null;
 		return { databaseUrl };
 	} catch (error) {
 		if (error instanceof Error) consola$1.error(error.message);
@@ -3880,10 +3868,7 @@ async function setupPrismaPostgres(config) {
 			options: setupOptions,
 			initialValue: "create-db"
 		});
-		if (isCancel(setupMethod)) {
-			cancel(pc.red("Operation cancelled"));
-			process.exit(0);
-		}
+		if (isCancel(setupMethod)) return exitCancelled("Operation cancelled");
 		let prismaConfig = null;
 		if (setupMethod === "create-db") prismaConfig = await setupWithCreateDb(serverDir, packageManager, orm);
 		else prismaConfig = await initPrismaDatabase(serverDir, packageManager);
@@ -4117,10 +4102,7 @@ async function selectTursoGroup() {
 		message: "Select a Turso database group:",
 		options: groupOptions
 	});
-	if (isCancel(selectedGroup)) {
-		cancel(pc.red("Operation cancelled"));
-		process.exit(0);
-	}
+	if (isCancel(selectedGroup)) return exitCancelled("Operation cancelled");
 	return selectedGroup;
 }
 async function createTursoDatabase(dbName, groupName) {
@@ -4193,10 +4175,7 @@ async function setupTurso(config) {
 				message: "Would you like to install Turso CLI?",
 				initialValue: true
 			});
-			if (isCancel(shouldInstall)) {
-				cancel(pc.red("Operation cancelled"));
-				process.exit(0);
-			}
+			if (isCancel(shouldInstall)) return exitCancelled("Operation cancelled");
 			if (!shouldInstall) {
 				await writeEnvFile(projectDir);
 				displayManualSetupInstructions();
@@ -4217,10 +4196,7 @@ async function setupTurso(config) {
 				initialValue: suggestedName,
 				placeholder: suggestedName
 			});
-			if (isCancel(dbNameResponse)) {
-				cancel(pc.red("Operation cancelled"));
-				process.exit(0);
-			}
+			if (isCancel(dbNameResponse)) return exitCancelled("Operation cancelled");
 			dbName = dbNameResponse;
 			try {
 				const config$1 = await createTursoDatabase(dbName, selectedGroup);
@@ -5137,13 +5113,11 @@ async function createProject(options) {
 		return projectDir;
 	} catch (error) {
 		if (error instanceof Error) {
-			cancel(pc.red(`Error during project creation: ${error.message}`));
 			console.error(error.stack);
-			process.exit(1);
+			exitWithError(`Error during project creation: ${error.message}`);
 		} else {
-			cancel(pc.red(`An unexpected error occurred: ${String(error)}`));
 			console.error(error);
-			process.exit(1);
+			exitWithError(`An unexpected error occurred: ${String(error)}`);
 		}
 	}
 }
@@ -5202,18 +5176,14 @@ async function createProjectHandler(input) {
 		const elapsedTimeInSeconds = ((Date.now() - startTime) / 1e3).toFixed(2);
 		outro(pc.magenta(`Project created successfully in ${pc.bold(elapsedTimeInSeconds)} seconds!`));
 	} catch (error) {
-		console.error(error);
-		process.exit(1);
+		handleError(error, "Failed to create project");
 	}
 }
 async function addAddonsHandler(input) {
 	try {
 		const projectDir = input.projectDir || process.cwd();
 		const detectedConfig = await detectProjectConfig(projectDir);
-		if (!detectedConfig) {
-			cancel(pc.red("Could not detect project configuration. Please ensure this is a valid Better-T Stack project."));
-			process.exit(1);
-		}
+		if (!detectedConfig) exitWithError("Could not detect project configuration. Please ensure this is a valid Better-T Stack project.");
 		if (!input.addons || input.addons.length === 0) {
 			const addonsPrompt = await getAddonsToAdd(detectedConfig.frontend || [], detectedConfig.addons || []);
 			if (addonsPrompt.length > 0) input.addons = addonsPrompt;
@@ -5253,8 +5223,7 @@ async function addAddonsHandler(input) {
 		else log.info(`Run ${pc.bold(`${packageManager} install`)} to install dependencies`);
 		outro("Add command completed successfully!");
 	} catch (error) {
-		console.error(error);
-		process.exit(1);
+		handleError(error, "Failed to add addons or deployment");
 	}
 }
 
@@ -5369,8 +5338,7 @@ const router = t.router({
 			const sponsors = await fetchSponsors();
 			displaySponsors(sponsors);
 		} catch (error) {
-			consola$1.error(error);
-			process.exit(1);
+			handleError(error, "Failed to display sponsors");
 		}
 	}),
 	docs: t.procedure.meta({ description: "Open Better-T Stack documentation" }).mutation(async () => {