create-better-t-stack 2.29.2 → 2.29.4

package/README.md

@@ -15,14 +15,14 @@ A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with
 Run without installing globally:
 
 ```bash
-# Using npm
-npx create-better-t-stack@latest
-
-# Using bun
+# Using bun (recommended)
 bun create better-t-stack@latest
 
 # Using pnpm
 pnpm create better-t-stack@latest
+
+# Using npm
+npx create-better-t-stack@latest
 ```
 
 Follow the prompts to configure your project or use the `--yes` flag for defaults.
@@ -58,14 +58,15 @@ Options:
   --auth                          Include authentication
   --no-auth                       Exclude authentication
   --frontend <types...>           Frontend types (tanstack-router, react-router, tanstack-start, next, nuxt, svelte, solid, native-nativewind, native-unistyles, none)
-  --addons <types...>             Additional addons (pwa, tauri, starlight, biome, husky, turborepo, none)
+  --addons <types...>             Additional addons (pwa, tauri, starlight, biome, husky, turborepo, fumadocs, ultracite, oxlint, none)
   --examples <types...>           Examples to include (todo, ai, none)
   --git                           Initialize git repository
   --no-git                        Skip git initialization
   --package-manager <pm>          Package manager (npm, pnpm, bun)
   --install                       Install dependencies
   --no-install                    Skip installing dependencies
-  --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, mongodb-atlas, none)
+  --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, mongodb-atlas, docker, none)
+  --web-deploy <setup>            Web deployment (workers, none)
   --backend <framework>           Backend framework (hono, express, elysia, next, convex, fastify, none)
   --runtime <runtime>             Runtime (bun, node, workers, none)
   --api <type>                    API type (trpc, orpc, none)
@@ -84,7 +85,7 @@ This CLI collects anonymous usage data to help improve the tool. The data collec
 
 ### Disabling Telemetry
 
-You can disable telemetry by setting the `BTS_TELEMETRY` environment variable:
+You can disable telemetry by setting the `BTS_TELEMETRY_DISABLED` environment variable:
 
 ```bash
 # Disable telemetry for a single run
@@ -94,10 +95,6 @@ BTS_TELEMETRY_DISABLED=1 npx create-better-t-stack my-app
 export BTS_TELEMETRY_DISABLED=1
 ```
 
-### Development
-
-During development, telemetry is automatically disabled when `NODE_ENV=development`.
-
 ## Examples
 
 Create a project with default configuration:
@@ -118,10 +115,10 @@ Create a project with Elysia backend and Node.js runtime:
 npx create-better-t-stack my-app --backend elysia --runtime node
 ```
 
-Create a project with multiple frontend options:
+Create a project with multiple frontend options (one web + one native):
 
 ```bash
-npx create-better-t-stack my-app --frontend tanstack-router native
+npx create-better-t-stack my-app --frontend tanstack-router native-nativewind
 ```
 
 Create a project with examples:

package/dist/index.js

@@ -140,15 +140,6 @@ const ADDON_COMPATIBILITY = {
 	fumadocs: [],
 	none: []
 };
-const WEB_FRAMEWORKS = [
-	"tanstack-router",
-	"react-router",
-	"tanstack-start",
-	"next",
-	"nuxt",
-	"svelte",
-	"solid"
-];
 
 //#endregion
 //#region src/types.ts
@@ -179,7 +170,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",
@@ -407,40 +398,180 @@ async function getAddonsToAdd(frontend, existingAddons = []) {
 	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) {
+		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);
+	}
+}
+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);
+	}
+}
+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") {
+		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);
+	}
+}
+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) {
+		consola$1.fatal("'--web-deploy' requires a web frontend. Please select a web frontend or set '--web-deploy none'.");
+		process.exit(1);
+	}
+}
+
 //#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,
@@ -670,21 +801,23 @@ 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"));
@@ -754,10 +887,7 @@ async function getFrontendChoice(frontendOptions, backend) {
 				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,
@@ -1057,6 +1187,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 +1203,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,7 +1230,7 @@ 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;
 			}
@@ -1224,11 +1363,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(" ")}`;
 }
@@ -1422,18 +1561,10 @@ function processAndValidateFlags(options, providedFlags, projectName) {
 		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.`);
@@ -1451,159 +1582,94 @@ function processAndValidateFlags(options, providedFlags, projectName) {
 		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 (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 convex': ${incompatibleFlags.join(", ")}. Please remove them.`);
+			consola$1.fatal(`The following flags are incompatible with '--backend ${config.backend}': ${incompatibleFlags.join(", ")}. Please remove them.`);
 			process.exit(1);
 		}
-		if (providedFlags.has("frontend") && options.frontend) {
+		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);
 			}
 		}
-		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 = [];
+		coerceBackendPresets(config);
 	}
-	if (config.orm === "mongoose" && config.database !== "mongodb") {
+	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 (config.database === "mongodb" && config.orm && config.orm !== "mongoose" && config.orm !== "prisma") {
+	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 (config.orm === "drizzle" && config.database === "mongodb") {
+	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 (config.database && config.database !== "none" && config.orm === "none") {
+	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 (config.orm && config.orm !== "none" && config.database === "none") {
+	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 (config.auth && config.database === "none") {
+	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 (config.dbSetup && config.dbSetup !== "none" && config.database === "none") {
+	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 (config.dbSetup === "turso" && config.database !== "sqlite") {
+	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 (config.dbSetup === "neon" && config.database !== "postgres") {
+	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 (config.dbSetup === "prisma-postgres" && config.database !== "postgres") {
+	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 (config.dbSetup === "mongodb-atlas" && config.database !== "mongodb") {
+	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 (config.dbSetup === "supabase" && config.database !== "postgres") {
+	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 (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") {
+				consola$1.fatal("Cloudflare D1 setup requires SQLite database. Please use '--database sqlite' or choose a different setup.");
+				process.exit(1);
+			}
 		}
-		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") {
+				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.dbSetup === "docker" && config.database === "sqlite") {
+	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 (config.dbSetup === "docker" && config.runtime === "workers") {
+	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("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);
-	}
+	validateWorkersCompatibility(providedFlags, options, config);
+	const hasWebFrontendFlag = (config.frontend ?? []).some((f) => isWebFrontend(f));
+	validateWebDeployRequiresWebFrontend(config.webDeploy, hasWebFrontendFlag);
 	return config;
 }
 function getProvidedFlags(options) {
@@ -1779,7 +1845,7 @@ async function setupFumadocs(config) {
 			process.exit(0);
 		}
 		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"),
@@ -4417,7 +4483,7 @@ async function setupWorkersRuntime(serverDir) {
 	};
 	await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
 	await addPackageDependency({
-		devDependencies: ["wrangler"],
+		devDependencies: ["wrangler", "@types/node"],
 		projectDir: serverDir
 	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.29.2",
+  "version": "2.29.4",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "type": "module",
   "license": "MIT",
@@ -56,7 +56,7 @@
     "@clack/prompts": "^0.11.0",
     "consola": "^3.4.2",
     "execa": "^9.6.0",
-    "fs-extra": "^11.3.0",
+    "fs-extra": "^11.3.1",
     "globby": "^14.1.0",
     "gradient-string": "^3.0.0",
     "handlebars": "^4.7.8",
@@ -64,7 +64,7 @@
     "picocolors": "^1.1.1",
     "trpc-cli": "^0.10.2",
     "ts-morph": "^26.0.0",
-    "zod": "^4.0.14"
+    "zod": "^4.0.15"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",