create-better-t-stack 3.26.1 → 3.27.1

package/README.md

@@ -217,6 +217,12 @@ Create a Cloudflare Workers project:
 npx create-better-t-stack --backend hono --runtime workers --database sqlite --orm drizzle --db-setup d1
 ```
 
+Create a self-hosted fullstack project on Cloudflare with D1:
+
+```bash
+npx create-better-t-stack --backend self --frontend next --api trpc --database sqlite --orm drizzle --db-setup d1 --web-deploy cloudflare
+```
+
 Create a minimal API-only project:
 
 ```bash
@@ -232,7 +238,8 @@ npx create-better-t-stack --frontend none --backend hono --api trpc --database n
 - **Database 'none'**: Disables database setup and requires ORM to be `none`.
 - **ORM 'none'**: Can be used when you want to handle database operations manually or use a different ORM.
 - **Runtime 'none'**: Only available with Convex backend, backend `none`, or backend `self`.
-- **Cloudflare Workers runtime**: Only compatible with Hono backend, Drizzle ORM (or no ORM), and SQLite database (with D1 setup). Not compatible with MongoDB.
+- **Cloudflare Workers runtime**: Only compatible with Hono backend. If a database is used, MongoDB is not supported.
+- **Cloudflare D1 setup**: Requires `sqlite` and either `--runtime workers --server-deploy cloudflare` or `--backend self --web-deploy cloudflare`. For `backend self`, D1 is supported on `next`, `tanstack-start`, `nuxt`, and `astro`.
 - **Addons 'none'**: Skips all addons.
 - **Examples 'none'**: Skips all example implementations (todo, AI chat).
 - **Nuxt, Svelte, SolidJS, and Astro** frontends are only compatible with oRPC API layer

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { _ as types_exports, i as SchemaNameSchema, l as create, m as getSchemaResult, s as add, u as createBtsCli, v as getLatestCLIVersion } from "./src-Kus6HC8q.mjs";
+import { _ as types_exports, i as SchemaNameSchema, l as create, m as getSchemaResult, s as add, u as createBtsCli, v as getLatestCLIVersion } from "./src-nmBsmday.mjs";
 import z from "zod";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

package/dist/index.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { C as ProjectCreationError, S as DirectoryConflictError, T as ValidationError, a as TEMPLATE_COUNT, b as CompatibilityError, c as builder, d as createVirtual, f as docs, g as sponsors, h as router, i as SchemaNameSchema, l as create, m as getSchemaResult, n as GeneratorError, o as VirtualFileSystem, p as generate, r as Result, s as add, t as EMBEDDED_TEMPLATES, u as createBtsCli, w as UserCancelledError, x as DatabaseSetupError, y as CLIError } from "./src-Kus6HC8q.mjs";
+import { C as ProjectCreationError, S as DirectoryConflictError, T as ValidationError, a as TEMPLATE_COUNT, b as CompatibilityError, c as builder, d as createVirtual, f as docs, g as sponsors, h as router, i as SchemaNameSchema, l as create, m as getSchemaResult, n as GeneratorError, o as VirtualFileSystem, p as generate, r as Result, s as add, t as EMBEDDED_TEMPLATES, u as createBtsCli, w as UserCancelledError, x as DatabaseSetupError, y as CLIError } from "./src-nmBsmday.mjs";
 export { CLIError, CompatibilityError, DatabaseSetupError, DirectoryConflictError, EMBEDDED_TEMPLATES, GeneratorError, ProjectCreationError, Result, SchemaNameSchema, TEMPLATE_COUNT, UserCancelledError, ValidationError, VirtualFileSystem, add, builder, create, createBtsCli, createVirtual, docs, generate, getSchemaResult, router, sponsors };

package/dist/{src-Kus6HC8q.mjs → src-nmBsmday.mjs}

@@ -783,7 +783,6 @@ function validateWorkersCompatibility(providedFlags, options, config) {
 	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && config.backend !== "hono") return validationErr$1(`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") return validationErr$1(`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.database === "mongodb") return validationErr$1("Cloudflare Workers runtime (--runtime workers) is not compatible with MongoDB database. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle or Prisma ORM. Please use a different database or runtime.");
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.dbSetup === "docker") return validationErr$1("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") return validationErr$1("MongoDB database is not compatible with Cloudflare Workers runtime. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle or Prisma ORM. Please use a different database or runtime.");
 	return Result.ok(void 0);
 }
@@ -3212,7 +3211,11 @@ async function addHandlerInternal(input) {
 async function getApiChoice(Api, frontend, backend) {
 	if (backend === "convex" || backend === "none") return "none";
 	const allowed = allowedApisForFrontends(frontend ?? []);
-	if (Api) return allowed.includes(Api) ? Api : allowed[0];
+	if (Api) {
+		const compat = validateApiFrontendCompatibility(Api, frontend ?? []);
+		if (compat.isErr()) throw compat.error;
+		return Api;
+	}
 	const apiOptions = allowed.map((a) => a === "trpc" ? {
 		value: "trpc",
 		label: "tRPC",
@@ -3392,7 +3395,7 @@ async function getDBSetupChoice(databaseType, dbSetup, _orm, backend, runtime) {
 			label: "Turso",
 			hint: "SQLite for Production. Powered by libSQL"
 		},
-		...runtime === "workers" ? [{
+		...runtime === "workers" || backend === "self" ? [{
 			value: "d1",
 			label: "Cloudflare D1",
 			hint: "Cloudflare's managed, serverless database with SQLite's SQL semantics"
@@ -3701,6 +3704,209 @@ async function navigableGroup(prompts, opts) {
 	return results;
 }
 //#endregion
+//#region src/utils/config-validation.ts
+function validationErr(message) {
+	return Result.err(new ValidationError({ message }));
+}
+function hasResolvedWorkersD1Target(config) {
+	return config.backend === "hono" && config.runtime === "workers" && config.serverDeploy === "cloudflare";
+}
+function hasResolvedSelfCloudflareD1Target(config) {
+	return config.backend === "self" && config.runtime === "none" && config.webDeploy === "cloudflare";
+}
+function canResolveWorkersD1Target(config) {
+	return (config.backend === void 0 || config.backend === "hono") && (config.runtime === void 0 || config.runtime === "workers") && (config.serverDeploy === void 0 || config.serverDeploy === "cloudflare");
+}
+function canResolveSelfCloudflareD1Target(config) {
+	return (config.backend === void 0 || config.backend === "self") && (config.runtime === void 0 || config.runtime === "none") && (config.webDeploy === void 0 || config.webDeploy === "cloudflare");
+}
+/**
+* Pure ORM + database compatibility check. Used by the flag-path
+* validator below and by the orm prompt directly (for flag+prompt
+* combos where one value came from a flag and the other from a
+* prompt).
+*/
+function validateOrmDatabaseCompat(orm, database) {
+	if (orm === "mongoose" && database && database !== "mongodb") return validationErr("Mongoose ORM requires MongoDB database. Please use '--database mongodb' or choose a different ORM.");
+	if (orm === "drizzle" && database === "mongodb") return validationErr("Drizzle ORM does not support MongoDB. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
+	if (database === "mongodb" && orm && orm !== "mongoose" && orm !== "prisma" && orm !== "none") return validationErr("MongoDB database requires Mongoose or Prisma ORM. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
+	if (database && database !== "none" && orm === "none") return validationErr("Database selection requires an ORM. Please choose '--orm drizzle', '--orm prisma', or '--orm mongoose'.");
+	if (orm && orm !== "none" && database === "none") return validationErr("ORM selection requires a database. Please choose a database or set '--orm none'.");
+	return Result.ok(void 0);
+}
+function validateDatabaseOrmAuth(cfg, flags) {
+	const has = (k) => flags ? flags.has(k) : true;
+	if (!has("orm") || !has("database")) return Result.ok(void 0);
+	return validateOrmDatabaseCompat(cfg.orm, cfg.database);
+}
+function validateDatabaseSetup(config, providedFlags) {
+	const { dbSetup, database, runtime } = config;
+	if (providedFlags.has("dbSetup") && providedFlags.has("database") && dbSetup && dbSetup !== "none" && database === "none") return validationErr("Database setup requires a database. Please choose a database or set '--db-setup none'.");
+	const setupValidations = {
+		turso: {
+			database: "sqlite",
+			errorMessage: "Turso setup requires SQLite database. Please use '--database sqlite' or choose a different setup."
+		},
+		neon: {
+			database: "postgres",
+			errorMessage: "Neon setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup."
+		},
+		"prisma-postgres": {
+			database: "postgres",
+			errorMessage: "Prisma PostgreSQL setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup."
+		},
+		planetscale: { errorMessage: "PlanetScale setup requires PostgreSQL or MySQL database. Please use '--database postgres' or '--database mysql' or choose a different setup." },
+		"mongodb-atlas": {
+			database: "mongodb",
+			errorMessage: "MongoDB Atlas setup requires MongoDB database. Please use '--database mongodb' or choose a different setup."
+		},
+		supabase: {
+			database: "postgres",
+			errorMessage: "Supabase setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup."
+		},
+		d1: {
+			database: "sqlite",
+			errorMessage: "Cloudflare D1 setup requires SQLite database."
+		},
+		docker: { errorMessage: "Docker setup is not compatible with SQLite database or Cloudflare Workers runtime." },
+		none: { errorMessage: "" }
+	};
+	if (dbSetup && dbSetup !== "none") {
+		const validation = setupValidations[dbSetup];
+		if (dbSetup === "planetscale") {
+			if (database !== "postgres" && database !== "mysql") return validationErr(validation.errorMessage);
+		} else if (validation.database && database !== validation.database) return validationErr(validation.errorMessage);
+		if (validation.runtime && runtime !== validation.runtime) return validationErr(validation.errorMessage);
+		if (dbSetup === "d1") {
+			const isWorkersTarget = hasResolvedWorkersD1Target(config);
+			const isSelfCloudflareTarget = hasResolvedSelfCloudflareD1Target(config);
+			const canResolveWorkersTarget = canResolveWorkersD1Target(config);
+			const canResolveSelfCloudflareTarget = canResolveSelfCloudflareD1Target(config);
+			if (!isWorkersTarget && !isSelfCloudflareTarget && !canResolveWorkersTarget && !canResolveSelfCloudflareTarget) return validationErr("Cloudflare D1 setup requires SQLite database and either Cloudflare Workers runtime with server deployment or backend 'self' with Cloudflare web deployment.");
+		}
+		if (dbSetup === "docker") {
+			if (database === "sqlite") return validationErr("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 (runtime === "workers") return validationErr("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.");
+		}
+	}
+	return Result.ok(void 0);
+}
+function validateConvexConstraints(config, providedFlags) {
+	const { backend } = config;
+	if (backend !== "convex") return Result.ok(void 0);
+	const has = (k) => providedFlags.has(k);
+	if (has("runtime") && config.runtime !== "none") return validationErr("Convex backend requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
+	if (has("database") && config.database !== "none") return validationErr("Convex backend requires '--database none'. Please remove the --database flag or set it to 'none'.");
+	if (has("orm") && config.orm !== "none") return validationErr("Convex backend requires '--orm none'. Please remove the --orm flag or set it to 'none'.");
+	if (has("api") && config.api !== "none") return validationErr("Convex backend requires '--api none'. Please remove the --api flag or set it to 'none'.");
+	if (has("dbSetup") && config.dbSetup !== "none") return validationErr("Convex backend requires '--db-setup none'. Please remove the --db-setup flag or set it to 'none'.");
+	if (has("serverDeploy") && config.serverDeploy !== "none") return validationErr("Convex backend requires '--server-deploy none'. Please remove the --server-deploy flag or set it to 'none'.");
+	if (has("auth") && config.auth === "better-auth") {
+		const incompatibleFrontends = config.frontend?.filter((f) => CONVEX_BETTER_AUTH_INCOMPATIBLE_FRONTENDS.includes(f)) ?? [];
+		const hasSupportedFrontend = supportsConvexBetterAuth(config.frontend);
+		if (incompatibleFrontends.length > 0) return validationErr(`Better Auth with '--backend convex' is not compatible with the following frontends: ${incompatibleFrontends.join(", ")}. Please use a React-based web frontend (next, tanstack-start, tanstack-router, react-router), a supported native frontend, or choose a different auth provider.`);
+		if (!hasSupportedFrontend) return validationErr(`Better Auth with '--backend convex' requires a supported frontend (${CONVEX_BETTER_AUTH_SUPPORTED_FRONTENDS.join(", ")}).`);
+	}
+	return Result.ok(void 0);
+}
+function validateBackendNoneConstraints(config, providedFlags) {
+	const { backend } = config;
+	if (backend !== "none") return Result.ok(void 0);
+	const has = (k) => providedFlags.has(k);
+	if (has("runtime") && config.runtime !== "none") return validationErr("Backend 'none' requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
+	if (has("database") && config.database !== "none") return validationErr("Backend 'none' requires '--database none'. Please remove the --database flag or set it to 'none'.");
+	if (has("orm") && config.orm !== "none") return validationErr("Backend 'none' requires '--orm none'. Please remove the --orm flag or set it to 'none'.");
+	if (has("api") && config.api !== "none") return validationErr("Backend 'none' requires '--api none'. Please remove the --api flag or set it to 'none'.");
+	if (has("auth") && config.auth !== "none") return validationErr("Backend 'none' requires '--auth none'. Please remove the --auth flag or set it to 'none'.");
+	if (has("payments") && config.payments !== "none") return validationErr("Backend 'none' requires '--payments none'. Please remove the --payments flag or set it to 'none'.");
+	if (has("dbSetup") && config.dbSetup !== "none") return validationErr("Backend 'none' requires '--db-setup none'. Please remove the --db-setup flag or set it to 'none'.");
+	if (has("serverDeploy") && config.serverDeploy !== "none") return validationErr("Backend 'none' requires '--server-deploy none'. Please remove the --server-deploy flag or set it to 'none'.");
+	return Result.ok(void 0);
+}
+function validateSelfBackendConstraints(config, providedFlags) {
+	const { backend } = config;
+	if (backend !== "self") return Result.ok(void 0);
+	const has = (k) => providedFlags.has(k);
+	if (has("runtime") && config.runtime !== "none") return validationErr("Backend 'self' (fullstack) requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
+	return Result.ok(void 0);
+}
+function validateBackendConstraints(config, providedFlags, options) {
+	const { backend } = config;
+	if (config.auth === "clerk" && config.frontend) {
+		const incompatibleFrontends = config.frontend.filter((f) => [
+			"nuxt",
+			"svelte",
+			"solid",
+			"astro"
+		].includes(f));
+		if (incompatibleFrontends.length > 0) return validationErr(`Clerk authentication is not compatible with the following frontends: ${incompatibleFrontends.join(", ")}. Please choose a different frontend or auth provider.`);
+	}
+	if (providedFlags.has("backend") && backend && backend !== "convex" && backend !== "none" && backend !== "self") {
+		if (providedFlags.has("runtime") && options.runtime === "none") return validationErr("'--runtime none' is only supported with '--backend convex', '--backend none', or '--backend self'. Please choose 'bun', 'node', or remove the --runtime flag.");
+	}
+	if (backend === "convex" && providedFlags.has("frontend") && options.frontend) {
+		const incompatibleFrontends = options.frontend.filter((f) => f === "solid" || f === "astro");
+		if (incompatibleFrontends.length > 0) return validationErr(`The following frontends are not compatible with '--backend convex': ${incompatibleFrontends.join(", ")}. Please choose a different frontend or backend.`);
+	}
+	return Result.ok(void 0);
+}
+function validateFrontendConstraints(config, providedFlags) {
+	const { frontend } = config;
+	if (frontend && frontend.length > 0) {
+		const singleWebNativeResult = ensureSingleWebAndNative(frontend);
+		if (singleWebNativeResult.isErr()) return singleWebNativeResult;
+		if (providedFlags.has("api") && providedFlags.has("frontend") && config.api) {
+			const apiResult = validateApiFrontendCompatibility(config.api, frontend);
+			if (apiResult.isErr()) return apiResult;
+		}
+	}
+	const hasWebFrontendFlag = (frontend ?? []).some((f) => isWebFrontend(f));
+	const webDeployResult = validateWebDeployRequiresWebFrontend(config.webDeploy, hasWebFrontendFlag);
+	if (webDeployResult.isErr()) return webDeployResult;
+	return Result.ok(void 0);
+}
+function validateApiConstraints(config, options) {
+	if (config.api === "none") {
+		if (options.examples?.includes("todo") && options.backend !== "convex" && options.backend !== "none") return validationErr("Cannot use '--examples todo' when '--api' is set to 'none'. The todo example requires an API layer. Please remove 'todo' from --examples or choose an API type.");
+	}
+	return Result.ok(void 0);
+}
+function validateFullConfig(config, providedFlags, options) {
+	return Result.gen(function* () {
+		yield* validateDatabaseOrmAuth(config, providedFlags);
+		yield* validateDatabaseSetup(config, providedFlags);
+		yield* validateConvexConstraints(config, providedFlags);
+		yield* validateBackendNoneConstraints(config, providedFlags);
+		yield* validateSelfBackendConstraints(config, providedFlags);
+		yield* validateBackendConstraints(config, providedFlags, options);
+		yield* validateFrontendConstraints(config, providedFlags);
+		yield* validateApiConstraints(config, options);
+		yield* validateServerDeployRequiresBackend(config.serverDeploy, config.backend);
+		yield* validateSelfBackendCompatibility(providedFlags, options, config);
+		yield* validateWorkersCompatibility(providedFlags, options, config);
+		if (config.runtime === "workers" && config.serverDeploy === "none") yield* validationErr("Cloudflare Workers runtime requires a server deployment. Please choose 'cloudflare' for --server-deploy.");
+		if (providedFlags.has("serverDeploy") && config.serverDeploy === "cloudflare" && config.runtime !== "workers") yield* validationErr(`Server deployment '${config.serverDeploy}' requires '--runtime workers'. Please use '--runtime workers' or choose a different server deployment.`);
+		if (config.addons && config.addons.length > 0) {
+			yield* validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
+			config.addons = [...new Set(config.addons)];
+		}
+		yield* validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
+		yield* validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend ?? []);
+		return Result.ok(void 0);
+	});
+}
+function validateConfigForProgrammaticUse(config) {
+	return Result.gen(function* () {
+		yield* validateDatabaseOrmAuth(config);
+		if (config.frontend && config.frontend.length > 0) yield* ensureSingleWebAndNative(config.frontend);
+		yield* validateApiFrontendCompatibility(config.api, config.frontend);
+		yield* validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend);
+		if (config.addons && config.addons.length > 0) yield* validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
+		yield* validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
+		return Result.ok(void 0);
+	});
+}
+//#endregion
 //#region src/prompts/orm.ts
 const ormOptions = {
 	prisma: {
@@ -3722,7 +3928,11 @@ const ormOptions = {
 async function getORMChoice(orm, hasDatabase, database, backend, runtime) {
 	if (backend === "convex") return "none";
 	if (!hasDatabase) return "none";
-	if (orm !== void 0) return orm;
+	if (orm !== void 0) {
+		const compat = validateOrmDatabaseCompat(orm, database);
+		if (compat.isErr()) throw compat.error;
+		return orm;
+	}
 	const response = await navigableSelect({
 		message: "Select ORM",
 		options: database === "mongodb" ? [ormOptions.prisma, ormOptions.mongoose] : [ormOptions.drizzle, ormOptions.prisma],
@@ -3832,9 +4042,10 @@ function getDeploymentDisplay(deployment) {
 		hint: `Add ${deployment} deployment`
 	};
 }
-async function getDeploymentChoice(deployment, _runtime, _backend, frontend = []) {
+async function getDeploymentChoice(deployment, _runtime, backend, frontend = [], dbSetup) {
 	if (deployment !== void 0) return deployment;
 	if (!hasWebFrontend(frontend)) return "none";
+	if (backend === "self" && dbSetup === "d1") return "cloudflare";
 	const response = await navigableSelect({
 		message: "Select web deployment",
 		options: ["cloudflare", "none"].map((deploy) => {
@@ -3888,7 +4099,7 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		addons: ({ results }) => getAddonsChoice(flags.addons, results.frontend, results.auth),
 		examples: ({ results }) => getExamplesChoice(flags.examples, results.database, results.frontend, results.backend, results.api),
 		dbSetup: ({ results }) => getDBSetupChoice(results.database ?? "none", flags.dbSetup, results.orm, results.backend, results.runtime),
-		webDeploy: ({ results }) => getDeploymentChoice(flags.webDeploy, results.runtime, results.backend, results.frontend),
+		webDeploy: ({ results }) => getDeploymentChoice(flags.webDeploy, results.runtime, results.backend, results.frontend, results.dbSetup),
 		serverDeploy: ({ results }) => getServerDeploymentChoice(flags.serverDeploy, results.runtime, results.backend, results.webDeploy),
 		git: () => getGitChoice(flags.git),
 		packageManager: () => getPackageManagerChoice(flags.packageManager),
@@ -4301,183 +4512,6 @@ function validateArrayOptions(options) {
 	return Result.ok(void 0);
 }
 //#endregion
-//#region src/utils/config-validation.ts
-function validationErr(message) {
-	return Result.err(new ValidationError({ message }));
-}
-function validateDatabaseOrmAuth(cfg, flags) {
-	const db = cfg.database;
-	const orm = cfg.orm;
-	const has = (k) => flags ? flags.has(k) : true;
-	if (has("orm") && has("database") && orm === "mongoose" && db !== "mongodb") return validationErr("Mongoose ORM requires MongoDB database. Please use '--database mongodb' or choose a different ORM.");
-	if (has("orm") && has("database") && orm === "drizzle" && db === "mongodb") return validationErr("Drizzle ORM does not support MongoDB. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
-	if (has("database") && has("orm") && db === "mongodb" && orm && orm !== "mongoose" && orm !== "prisma" && orm !== "none") return validationErr("MongoDB database requires Mongoose or Prisma ORM. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
-	if (has("database") && has("orm") && db && db !== "none" && orm === "none") return validationErr("Database selection requires an ORM. Please choose '--orm drizzle', '--orm prisma', or '--orm mongoose'.");
-	if (has("orm") && has("database") && orm && orm !== "none" && db === "none") return validationErr("ORM selection requires a database. Please choose a database or set '--orm none'.");
-	return Result.ok(void 0);
-}
-function validateDatabaseSetup(config, providedFlags) {
-	const { dbSetup, database, runtime } = config;
-	if (providedFlags.has("dbSetup") && providedFlags.has("database") && dbSetup && dbSetup !== "none" && database === "none") return validationErr("Database setup requires a database. Please choose a database or set '--db-setup none'.");
-	const setupValidations = {
-		turso: {
-			database: "sqlite",
-			errorMessage: "Turso setup requires SQLite database. Please use '--database sqlite' or choose a different setup."
-		},
-		neon: {
-			database: "postgres",
-			errorMessage: "Neon setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup."
-		},
-		"prisma-postgres": {
-			database: "postgres",
-			errorMessage: "Prisma PostgreSQL setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup."
-		},
-		planetscale: { errorMessage: "PlanetScale setup requires PostgreSQL or MySQL database. Please use '--database postgres' or '--database mysql' or choose a different setup." },
-		"mongodb-atlas": {
-			database: "mongodb",
-			errorMessage: "MongoDB Atlas setup requires MongoDB database. Please use '--database mongodb' or choose a different setup."
-		},
-		supabase: {
-			database: "postgres",
-			errorMessage: "Supabase setup requires PostgreSQL database. Please use '--database postgres' or choose a different setup."
-		},
-		d1: {
-			database: "sqlite",
-			runtime: "workers",
-			errorMessage: "Cloudflare D1 setup requires SQLite database and Cloudflare Workers runtime."
-		},
-		docker: { errorMessage: "Docker setup is not compatible with SQLite database or Cloudflare Workers runtime." },
-		none: { errorMessage: "" }
-	};
-	if (dbSetup && dbSetup !== "none") {
-		const validation = setupValidations[dbSetup];
-		if (dbSetup === "planetscale") {
-			if (database !== "postgres" && database !== "mysql") return validationErr(validation.errorMessage);
-		} else if (validation.database && database !== validation.database) return validationErr(validation.errorMessage);
-		if (validation.runtime && runtime !== validation.runtime) return validationErr(validation.errorMessage);
-		if (dbSetup === "docker") {
-			if (database === "sqlite") return validationErr("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 (runtime === "workers") return validationErr("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.");
-		}
-	}
-	return Result.ok(void 0);
-}
-function validateConvexConstraints(config, providedFlags) {
-	const { backend } = config;
-	if (backend !== "convex") return Result.ok(void 0);
-	const has = (k) => providedFlags.has(k);
-	if (has("runtime") && config.runtime !== "none") return validationErr("Convex backend requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
-	if (has("database") && config.database !== "none") return validationErr("Convex backend requires '--database none'. Please remove the --database flag or set it to 'none'.");
-	if (has("orm") && config.orm !== "none") return validationErr("Convex backend requires '--orm none'. Please remove the --orm flag or set it to 'none'.");
-	if (has("api") && config.api !== "none") return validationErr("Convex backend requires '--api none'. Please remove the --api flag or set it to 'none'.");
-	if (has("dbSetup") && config.dbSetup !== "none") return validationErr("Convex backend requires '--db-setup none'. Please remove the --db-setup flag or set it to 'none'.");
-	if (has("serverDeploy") && config.serverDeploy !== "none") return validationErr("Convex backend requires '--server-deploy none'. Please remove the --server-deploy flag or set it to 'none'.");
-	if (has("auth") && config.auth === "better-auth") {
-		const incompatibleFrontends = config.frontend?.filter((f) => CONVEX_BETTER_AUTH_INCOMPATIBLE_FRONTENDS.includes(f)) ?? [];
-		const hasSupportedFrontend = supportsConvexBetterAuth(config.frontend);
-		if (incompatibleFrontends.length > 0) return validationErr(`Better Auth with '--backend convex' is not compatible with the following frontends: ${incompatibleFrontends.join(", ")}. Please use a React-based web frontend (next, tanstack-start, tanstack-router, react-router), a supported native frontend, or choose a different auth provider.`);
-		if (!hasSupportedFrontend) return validationErr(`Better Auth with '--backend convex' requires a supported frontend (${CONVEX_BETTER_AUTH_SUPPORTED_FRONTENDS.join(", ")}).`);
-	}
-	return Result.ok(void 0);
-}
-function validateBackendNoneConstraints(config, providedFlags) {
-	const { backend } = config;
-	if (backend !== "none") return Result.ok(void 0);
-	const has = (k) => providedFlags.has(k);
-	if (has("runtime") && config.runtime !== "none") return validationErr("Backend 'none' requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
-	if (has("database") && config.database !== "none") return validationErr("Backend 'none' requires '--database none'. Please remove the --database flag or set it to 'none'.");
-	if (has("orm") && config.orm !== "none") return validationErr("Backend 'none' requires '--orm none'. Please remove the --orm flag or set it to 'none'.");
-	if (has("api") && config.api !== "none") return validationErr("Backend 'none' requires '--api none'. Please remove the --api flag or set it to 'none'.");
-	if (has("auth") && config.auth !== "none") return validationErr("Backend 'none' requires '--auth none'. Please remove the --auth flag or set it to 'none'.");
-	if (has("payments") && config.payments !== "none") return validationErr("Backend 'none' requires '--payments none'. Please remove the --payments flag or set it to 'none'.");
-	if (has("dbSetup") && config.dbSetup !== "none") return validationErr("Backend 'none' requires '--db-setup none'. Please remove the --db-setup flag or set it to 'none'.");
-	if (has("serverDeploy") && config.serverDeploy !== "none") return validationErr("Backend 'none' requires '--server-deploy none'. Please remove the --server-deploy flag or set it to 'none'.");
-	return Result.ok(void 0);
-}
-function validateSelfBackendConstraints(config, providedFlags) {
-	const { backend } = config;
-	if (backend !== "self") return Result.ok(void 0);
-	const has = (k) => providedFlags.has(k);
-	if (has("runtime") && config.runtime !== "none") return validationErr("Backend 'self' (fullstack) requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
-	return Result.ok(void 0);
-}
-function validateBackendConstraints(config, providedFlags, options) {
-	const { backend } = config;
-	if (config.auth === "clerk" && config.frontend) {
-		const incompatibleFrontends = config.frontend.filter((f) => [
-			"nuxt",
-			"svelte",
-			"solid",
-			"astro"
-		].includes(f));
-		if (incompatibleFrontends.length > 0) return validationErr(`Clerk authentication is not compatible with the following frontends: ${incompatibleFrontends.join(", ")}. Please choose a different frontend or auth provider.`);
-	}
-	if (providedFlags.has("backend") && backend && backend !== "convex" && backend !== "none" && backend !== "self") {
-		if (providedFlags.has("runtime") && options.runtime === "none") return validationErr("'--runtime none' is only supported with '--backend convex', '--backend none', or '--backend self'. Please choose 'bun', 'node', or remove the --runtime flag.");
-	}
-	if (backend === "convex" && providedFlags.has("frontend") && options.frontend) {
-		const incompatibleFrontends = options.frontend.filter((f) => f === "solid" || f === "astro");
-		if (incompatibleFrontends.length > 0) return validationErr(`The following frontends are not compatible with '--backend convex': ${incompatibleFrontends.join(", ")}. Please choose a different frontend or backend.`);
-	}
-	return Result.ok(void 0);
-}
-function validateFrontendConstraints(config, providedFlags) {
-	const { frontend } = config;
-	if (frontend && frontend.length > 0) {
-		const singleWebNativeResult = ensureSingleWebAndNative(frontend);
-		if (singleWebNativeResult.isErr()) return singleWebNativeResult;
-		if (providedFlags.has("api") && providedFlags.has("frontend") && config.api) {
-			const apiResult = validateApiFrontendCompatibility(config.api, frontend);
-			if (apiResult.isErr()) return apiResult;
-		}
-	}
-	const hasWebFrontendFlag = (frontend ?? []).some((f) => isWebFrontend(f));
-	const webDeployResult = validateWebDeployRequiresWebFrontend(config.webDeploy, hasWebFrontendFlag);
-	if (webDeployResult.isErr()) return webDeployResult;
-	return Result.ok(void 0);
-}
-function validateApiConstraints(config, options) {
-	if (config.api === "none") {
-		if (options.examples?.includes("todo") && options.backend !== "convex" && options.backend !== "none") return validationErr("Cannot use '--examples todo' when '--api' is set to 'none'. The todo example requires an API layer. Please remove 'todo' from --examples or choose an API type.");
-	}
-	return Result.ok(void 0);
-}
-function validateFullConfig(config, providedFlags, options) {
-	return Result.gen(function* () {
-		yield* validateDatabaseOrmAuth(config, providedFlags);
-		yield* validateDatabaseSetup(config, providedFlags);
-		yield* validateConvexConstraints(config, providedFlags);
-		yield* validateBackendNoneConstraints(config, providedFlags);
-		yield* validateSelfBackendConstraints(config, providedFlags);
-		yield* validateBackendConstraints(config, providedFlags, options);
-		yield* validateFrontendConstraints(config, providedFlags);
-		yield* validateApiConstraints(config, options);
-		yield* validateServerDeployRequiresBackend(config.serverDeploy, config.backend);
-		yield* validateSelfBackendCompatibility(providedFlags, options, config);
-		yield* validateWorkersCompatibility(providedFlags, options, config);
-		if (config.runtime === "workers" && config.serverDeploy === "none") yield* validationErr("Cloudflare Workers runtime requires a server deployment. Please choose 'cloudflare' for --server-deploy.");
-		if (providedFlags.has("serverDeploy") && config.serverDeploy === "cloudflare" && config.runtime !== "workers") yield* validationErr(`Server deployment '${config.serverDeploy}' requires '--runtime workers'. Please use '--runtime workers' or choose a different server deployment.`);
-		if (config.addons && config.addons.length > 0) {
-			yield* validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
-			config.addons = [...new Set(config.addons)];
-		}
-		yield* validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
-		yield* validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend ?? []);
-		return Result.ok(void 0);
-	});
-}
-function validateConfigForProgrammaticUse(config) {
-	return Result.gen(function* () {
-		yield* validateDatabaseOrmAuth(config);
-		if (config.frontend && config.frontend.length > 0) yield* ensureSingleWebAndNative(config.frontend);
-		yield* validateApiFrontendCompatibility(config.api, config.frontend);
-		yield* validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend);
-		if (config.addons && config.addons.length > 0) yield* validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
-		yield* validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
-		return Result.ok(void 0);
-	});
-}
-//#endregion
 //#region src/validation.ts
 const CORE_STACK_FLAGS = new Set([
 	"database",
@@ -4612,8 +4646,8 @@ async function addEnvVariablesToFile(envPath, variables) {
 //#endregion
 //#region src/helpers/database-providers/d1-setup.ts
 async function setupCloudflareD1(config) {
-	const { projectDir, serverDeploy, orm, backend } = config;
-	if (!(serverDeploy === "cloudflare" && orm === "prisma")) return Result.ok(void 0);
+	const { projectDir, serverDeploy, webDeploy, orm, backend } = config;
+	if (!(orm === "prisma" && (serverDeploy === "cloudflare" || backend === "self" && webDeploy === "cloudflare"))) return Result.ok(void 0);
 	return Result.tryPromise({
 		try: async () => {
 			const targetApp = backend === "self" ? "apps/web" : "apps/server";
@@ -5995,7 +6029,7 @@ async function displayPostInstallInstructions(config) {
 	const hasHusky = addons?.includes("husky");
 	const hasLefthook = addons?.includes("lefthook");
 	const hasGitHooksOrLinting = addons?.includes("husky") || addons?.includes("biome") || addons?.includes("lefthook") || addons?.includes("oxlint");
-	const databaseInstructions = !isConvex && database !== "none" ? await getDatabaseInstructions(database, orm, runCmd, runtime, dbSetup, serverDeploy, backend) : "";
+	const databaseInstructions = !isConvex && database !== "none" ? await getDatabaseInstructions(database, orm, runCmd, runtime, dbSetup, webDeploy, serverDeploy, backend) : "";
 	const tauriInstructions = addons?.includes("tauri") ? getTauriInstructions(runCmd, frontend) : "";
 	const electrobunInstructions = addons?.includes("electrobun") ? getElectrobunInstructions(runCmd, frontend) : "";
 	const huskyInstructions = hasHusky ? getHuskyInstructions(runCmd) : "";
@@ -6088,8 +6122,9 @@ function getLefthookInstructions(packageManager) {
 	const cmd = packageManager === "npm" ? "npx" : packageManager;
 	return `${pc.bold("Git hooks with Lefthook:")}\n${pc.cyan("•")} Install hooks: ${cmd} lefthook install\n`;
 }
-async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup, serverDeploy, _backend) {
+async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup, webDeploy, serverDeploy, backend) {
 	const instructions = [];
+	const isD1Alchemy = dbSetup === "d1" && (serverDeploy === "cloudflare" || backend === "self" && webDeploy === "cloudflare");
 	if (dbSetup === "docker") {
 		const dockerStatus = await getDockerStatus(database);
 		if (dockerStatus.message) {
@@ -6097,7 +6132,7 @@ async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup,
 			instructions.push("");
 		}
 	}
-	if (dbSetup === "d1" && serverDeploy === "cloudflare") {
+	if (isD1Alchemy) {
 		if (orm === "drizzle") instructions.push(`${pc.cyan("•")} Generate migrations: ${`${runCmd} db:generate`}`);
 		else if (orm === "prisma") {
 			instructions.push(`${pc.cyan("•")} Generate Prisma client: ${`${runCmd} db:generate`}`);
@@ -6112,15 +6147,15 @@ async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup,
 	if (orm === "prisma") {
 		if (database === "mongodb" && dbSetup === "docker") instructions.push(`${pc.yellow("WARNING:")} Prisma + MongoDB + Docker combination\n   may not work.`);
 		if (dbSetup === "docker") instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
-		if (!(dbSetup === "d1" && serverDeploy === "cloudflare")) {
+		if (!isD1Alchemy) {
 			instructions.push(`${pc.cyan("•")} Generate Prisma Client: ${`${runCmd} db:generate`}`);
 			instructions.push(`${pc.cyan("•")} Apply schema: ${`${runCmd} db:push`}`);
 		}
-		if (!(dbSetup === "d1" && serverDeploy === "cloudflare")) instructions.push(`${pc.cyan("•")} Database UI: ${`${runCmd} db:studio`}`);
+		if (!isD1Alchemy) instructions.push(`${pc.cyan("•")} Database UI: ${`${runCmd} db:studio`}`);
 	} else if (orm === "drizzle") {
 		if (dbSetup === "docker") instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
-		if (dbSetup !== "d1") instructions.push(`${pc.cyan("•")} Apply schema: ${`${runCmd} db:push`}`);
-		if (!(dbSetup === "d1" && serverDeploy === "cloudflare")) instructions.push(`${pc.cyan("•")} Database UI: ${`${runCmd} db:studio`}`);
+		if (!isD1Alchemy) instructions.push(`${pc.cyan("•")} Apply schema: ${`${runCmd} db:push`}`);
+		if (!isD1Alchemy) instructions.push(`${pc.cyan("•")} Database UI: ${`${runCmd} db:studio`}`);
 	} else if (orm === "mongoose") {
 		if (dbSetup === "docker") instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
 	} else if (orm === "none") instructions.push(`${pc.yellow("NOTE:")} Manual database schema setup\n   required.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "3.26.1",
+  "version": "3.27.1",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "keywords": [
     "better-auth",
@@ -70,8 +70,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-t-stack/template-generator": "^3.26.1",
-    "@better-t-stack/types": "^3.26.1",
+    "@better-t-stack/template-generator": "^3.27.1",
+    "@better-t-stack/types": "^3.27.1",
     "@clack/core": "^1.1.0",
     "@clack/prompts": "^1.1.0",
     "@modelcontextprotocol/sdk": "1.27.1",