create-better-t-stack 2.29.4 → 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,6 +136,7 @@ const ADDON_COMPATIBILITY = {
 	turborepo: [],
 	starlight: [],
 	ultracite: [],
+	"vibe-rules": [],
 	oxlint: [],
 	fumadocs: [],
 	none: []
@@ -189,6 +190,7 @@ const AddonsSchema = z.enum([
 	"starlight",
 	"biome",
 	"husky",
+	"vibe-rules",
 	"turborepo",
 	"fumadocs",
 	"ultracite",
@@ -258,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) {
@@ -288,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";
@@ -317,6 +339,7 @@ const ADDON_GROUPS = {
 		"ultracite"
 	],
 	Other: [
+		"vibe-rules",
 		"turborepo",
 		"pwa",
 		"tauri",
@@ -356,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 = []) {
@@ -391,10 +411,7 @@ 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;
 }
 
@@ -425,48 +442,18 @@ function splitFrontends(values = []) {
 }
 function ensureSingleWebAndNative(frontends) {
 	const { web, native } = splitFrontends(frontends);
-	if (web.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 (native.length > 1) {
-		consola$1.fatal("Cannot select multiple native frameworks. Choose only one of: native-nativewind, native-unistyles");
-		process.exit(1);
-	}
+	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") {
-		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("dbSetup") && 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);
-	}
+	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") {
@@ -516,10 +503,7 @@ 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") {
-		consola$1.fatal(`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.`);
-		process.exit(1);
-	}
+	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;
@@ -547,10 +531,7 @@ function isExampleAIAllowed(backend, frontends = []) {
 	return true;
 }
 function validateWebDeployRequiresWebFrontend(webDeploy, hasWebFrontendFlag) {
-	if (webDeploy && webDeploy !== "none" && !hasWebFrontendFlag) {
-		consola$1.fatal("'--web-deploy' requires a web frontend. Please select a web frontend or set '--web-deploy none'.");
-		process.exit(1);
-	}
+	if (webDeploy && webDeploy !== "none" && !hasWebFrontendFlag) exitWithError("'--web-deploy' requires a web frontend. Please select a web frontend or set '--web-deploy none'.");
 }
 
 //#endregion
@@ -577,10 +558,7 @@ async function getApiChoice(Api, frontend, backend) {
 		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;
 }
 
@@ -594,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;
 }
 
@@ -648,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;
 }
 
@@ -692,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;
 }
 
@@ -783,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;
 }
 
@@ -819,10 +785,7 @@ async function getExamplesChoice(examples, database, frontends, backend, api) {
 		required: false,
 		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;
 }
 
@@ -844,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 = [
@@ -883,7 +843,7 @@ 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"
 			}
 		];
@@ -893,10 +853,7 @@ async function getFrontendChoice(frontendOptions, backend) {
 			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")) {
@@ -913,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;
@@ -930,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;
 }
 
@@ -945,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;
 }
 
@@ -982,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;
 }
 
@@ -1015,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;
 }
 
@@ -1047,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;
 }
 
@@ -1086,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) {
@@ -1115,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;
 }
 
@@ -1140,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";
@@ -1235,10 +1165,7 @@ async function getProjectName(initialName) {
 				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;
 	}
@@ -1410,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,
@@ -1430,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.");
 		}
 	}
 }
@@ -1454,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 {
@@ -1515,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;
@@ -1539,25 +1454,16 @@ 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");
@@ -1566,17 +1472,11 @@ function processAndValidateFlags(options, providedFlags, projectName) {
 	}
 	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");
@@ -1584,89 +1484,35 @@ function processAndValidateFlags(options, providedFlags, projectName) {
 	}
 	if (config.backend === "convex" || config.backend === "none") {
 		const incompatibleFlags = incompatibleFlagsForBackend(config.backend, providedFlags, options);
-		if (incompatibleFlags.length > 0) {
-			consola$1.fatal(`The following flags are incompatible with '--backend ${config.backend}': ${incompatibleFlags.join(", ")}. Please remove them.`);
-			process.exit(1);
-		}
+		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.`);
 		}
 		coerceBackendPresets(config);
 	}
-	if (providedFlags.has("orm") && providedFlags.has("database") && 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 (providedFlags.has("database") && providedFlags.has("orm") && 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 (providedFlags.has("orm") && providedFlags.has("database") && 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 (providedFlags.has("database") && providedFlags.has("orm") && 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 (providedFlags.has("orm") && providedFlags.has("database") && 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 (providedFlags.has("auth") && providedFlags.has("database") && config.auth && config.database === "none") {
-		consola$1.fatal("Authentication requires a database. Please choose a database or set '--no-auth'.");
-		process.exit(1);
-	}
-	if (providedFlags.has("dbSetup") && providedFlags.has("database") && 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 (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && 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 (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && 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 (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && 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 (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && 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 (providedFlags.has("dbSetup") && (config.database ? providedFlags.has("database") : true) && 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);
-	}
+	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 (providedFlags.has("dbSetup") && providedFlags.has("database") || providedFlags.has("dbSetup") && !config.database) {
-			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 (config.database !== "sqlite") exitWithError("Cloudflare D1 setup requires SQLite database. Please use '--database sqlite' or choose a different setup.");
 		}
 		if (providedFlags.has("dbSetup") && providedFlags.has("runtime") || providedFlags.has("dbSetup") && !config.runtime) {
-			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 (config.runtime !== "workers") exitWithError("Cloudflare D1 setup requires the Cloudflare Workers runtime. Please use '--runtime workers' or choose a different setup.");
 		}
 	}
-	if (providedFlags.has("dbSetup") && providedFlags.has("database") && 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 (providedFlags.has("dbSetup") && providedFlags.has("runtime") && 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("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);
@@ -1840,10 +1686,7 @@ 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 --no-git`;
 		const fumadocsInitCommand = getPackageExecutionCommand(packageManager, commandWithArgs);
@@ -2007,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]) => ({
@@ -2020,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",
@@ -2055,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({
@@ -2146,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) {
@@ -2290,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) {
@@ -2525,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") {
@@ -2685,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,
@@ -2717,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 || [];
@@ -2732,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}`);
 	}
 }
 
@@ -2965,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();
@@ -3768,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);
@@ -3785,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();
@@ -3823,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);
@@ -3852,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);
@@ -3946,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);
@@ -4183,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) {
@@ -4259,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();
@@ -4283,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);
@@ -5203,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)}`);
 		}
 	}
 }
@@ -5268,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;
@@ -5319,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");
 	}
 }
 
@@ -5435,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 () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.29.4",
+  "version": "2.30.0",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "type": "module",
   "license": "MIT",

package/templates/addons/vibe-rules/.bts/rules.md.hbs

@@ -0,0 +1,132 @@
+# Better-T-Stack Project Rules
+
+This is a {{projectName}} project created with Better-T-Stack CLI.
+
+## Project Structure
+
+This is a monorepo with the following structure:
+
+{{#if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "tanstack-start")
+(includes frontend "next") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
+- **`apps/web/`** - Frontend application{{#if (includes frontend "tanstack-router")}} (React with TanStack Router){{else
+if (includes frontend "react-router")}} (React with React Router){{else if (includes frontend "next")}} (Next.js){{else
+if (includes frontend "nuxt")}} (Nuxt.js){{else if (includes frontend "svelte")}} (SvelteKit){{else if (includes
+frontend "solid")}} (SolidStart){{/if}}
+{{/if}}
+
+{{#if (ne backend "convex")}}
+{{#if (ne backend "none")}}
+- **`apps/server/`** - Backend server{{#if (eq backend "hono")}} (Hono){{else if (eq backend "express")}}
+(Express){{else if (eq backend "fastify")}} (Fastify){{else if (eq backend "elysia")}} (Elysia){{else if (eq backend
+"next")}} (Next.js API){{/if}}
+{{/if}}
+{{else}}
+- **`packages/backend/`** - Convex backend functions
+{{/if}}
+
+{{#if (or (includes frontend "native-nativewind") (includes frontend "native-unistyles"))}}
+- **`apps/native/`** - React Native mobile app{{#if (includes frontend "native-nativewind")}} (with NativeWind){{else if
+(includes frontend "native-unistyles")}} (with Unistyles){{/if}}
+{{/if}}
+
+## Available Scripts
+
+- `{{packageManager}} run dev` - Start all apps in development mode
+{{#if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "tanstack-start")
+(includes frontend "next") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
+- `{{packageManager}} run dev:web` - Start only the web app
+{{/if}}
+{{#if (ne backend "none")}}
+{{#if (ne backend "convex")}}
+- `{{packageManager}} run dev:server` - Start only the server
+{{/if}}
+{{/if}}
+{{#if (or (includes frontend "native-nativewind") (includes frontend "native-unistyles"))}}
+- `{{packageManager}} run dev:native` - Start only the native app
+{{/if}}
+
+{{#if (and (ne database "none") (ne orm "none") (ne backend "convex"))}}
+## Database Commands
+
+All database operations should be run from the server workspace:
+
+- `{{packageManager}} run db:push` - Push schema changes to database
+- `{{packageManager}} run db:studio` - Open database studio
+- `{{packageManager}} run db:generate` - Generate {{#if (eq orm "drizzle")}}Drizzle{{else if (eq orm
+"prisma")}}Prisma{{else}}{{orm}}{{/if}} files
+- `{{packageManager}} run db:migrate` - Run database migrations
+
+{{#if (eq orm "drizzle")}}
+Database schema files are located in `apps/server/src/db/schema/`
+{{else if (eq orm "prisma")}}
+Database schema is located in `apps/server/prisma/schema.prisma`
+{{else if (eq orm "mongoose")}}
+Database models are located in `apps/server/src/db/models/`
+{{/if}}
+{{/if}}
+
+{{#if (ne api "none")}}
+## API Structure
+
+{{#if (eq api "trpc")}}
+- tRPC routers are in `apps/server/src/routers/`
+- Client-side tRPC utils are in `apps/web/src/utils/trpc.ts`
+{{else if (eq api "orpc")}}
+- oRPC endpoints are in `apps/server/src/api/`
+- Client-side API utils are in `apps/web/src/utils/api.ts`
+{{/if}}
+{{/if}}
+
+{{#if auth}}
+## Authentication
+
+Authentication is enabled in this project:
+{{#if (ne backend "convex")}}
+- Server auth logic is in `apps/server/src/lib/auth.ts`
+{{#if (or (includes frontend "tanstack-router") (includes frontend "react-router") (includes frontend "tanstack-start")
+(includes frontend "next") (includes frontend "nuxt") (includes frontend "svelte") (includes frontend "solid"))}}
+- Web app auth client is in `apps/web/src/lib/auth-client.ts`
+{{/if}}
+{{#if (or (includes frontend "native-nativewind") (includes frontend "native-unistyles"))}}
+- Native app auth client is in `apps/native/src/lib/auth-client.ts`
+{{/if}}
+{{else}}
+{{/if}}
+{{/if}}
+
+## Adding More Features
+
+You can add additional addons or deployment options to your project using:
+
+```bash
+{{#if (eq packageManager "bun")}}bunx{{else if (eq packageManager "pnpm")}}pnpx{{else}}npx{{/if}} create-better-t-stack
+add
+```
+
+Available addons you can add:
+- **Documentation**: Starlight, Fumadocs
+- **Linting**: Biome, Oxlint, Ultracite
+- **Other**: vibe-rules, Turborepo, PWA, Tauri, Husky
+
+You can also add web deployment configurations like Cloudflare Workers support.
+
+## Project Configuration
+
+This project includes a `bts.jsonc` configuration file that stores your Better-T-Stack settings:
+
+- Contains your selected stack configuration (database, ORM, backend, frontend, etc.)
+- Used by the CLI to understand your project structure
+- Safe to delete if not needed
+- Updated automatically when using the `add` command
+
+## Key Points
+
+- This is a {{#if (includes addons "turborepo")}}Turborepo {{/if}}monorepo using {{packageManager}} workspaces
+- Each app has its own `package.json` and dependencies
+- Run commands from the root to execute across all workspaces
+- Run workspace-specific commands with `{{packageManager}} run command-name`
+{{#if (includes addons "turborepo")}}
+- Turborepo handles build caching and parallel execution
+{{/if}}
+- Use `{{#if (eq packageManager "bun")}}bunx{{else if (eq packageManager "pnpm")}}pnpx{{else}}npx{{/if}}
+create-better-t-stack add` to add more features later