create-better-fullstack 1.1.9 → 1.1.11

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { o as createBtsCli } from "./src-B07FiCRd.mjs";
+import { o as createBtsCli } from "./src-BkL9XJbn.mjs";
 
 //#region src/cli.ts
 createBtsCli().run();

package/dist/index.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { a as create, c as docs, d as sponsors, i as builder, l as generateVirtualProject, n as TEMPLATE_COUNT, o as createBtsCli, r as VirtualFileSystem, s as createVirtual, t as EMBEDDED_TEMPLATES, u as router } from "./src-B07FiCRd.mjs";
+import { a as create, c as docs, d as sponsors, i as builder, l as generateVirtualProject, n as TEMPLATE_COUNT, o as createBtsCli, r as VirtualFileSystem, s as createVirtual, t as EMBEDDED_TEMPLATES, u as router } from "./src-BkL9XJbn.mjs";
 
 export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, router, sponsors };

package/dist/{src-B07FiCRd.mjs → src-BkL9XJbn.mjs}

@@ -625,6 +625,67 @@ function handleError(error, fallbackMessage) {
 	process.exit(1);
 }
 
+//#endregion
+//#region src/utils/error-formatter.ts
+function getCategoryTitle(category) {
+	return {
+		incompatibility: "Incompatible Options",
+		"invalid-selection": "Invalid Selection",
+		"missing-requirement": "Missing Requirement",
+		constraint: "Constraint Violation"
+	}[category];
+}
+function displayStructuredError(error) {
+	if (isSilent()) throw new CLIError(error.message);
+	const lines = [];
+	lines.push(pc.bold(pc.red(getCategoryTitle(error.category))));
+	lines.push("");
+	lines.push(error.message);
+	if (error.provided && Object.keys(error.provided).length > 0) {
+		lines.push("");
+		lines.push(pc.dim("You provided:"));
+		for (const [key, value] of Object.entries(error.provided)) {
+			const displayValue = Array.isArray(value) ? value.join(", ") : value;
+			lines.push(`  ${pc.cyan("--" + key)} ${displayValue}`);
+		}
+	}
+	if (error.suggestions.length > 0) {
+		lines.push("");
+		lines.push(pc.dim("Suggestions:"));
+		for (const suggestion of error.suggestions) lines.push(`  ${pc.green("•")} ${suggestion}`);
+	}
+	consola.box({
+		title: pc.red("Error"),
+		message: lines.join("\n"),
+		style: { borderColor: "red" }
+	});
+	process.exit(1);
+}
+function incompatibilityError(opts) {
+	return displayStructuredError({
+		category: "incompatibility",
+		...opts
+	});
+}
+function invalidSelectionError(opts) {
+	return displayStructuredError({
+		category: "invalid-selection",
+		...opts
+	});
+}
+function missingRequirementError(opts) {
+	return displayStructuredError({
+		category: "missing-requirement",
+		...opts
+	});
+}
+function constraintError(opts) {
+	return displayStructuredError({
+		category: "constraint",
+		...opts
+	});
+}
+
 //#endregion
 //#region src/utils/compatibility-rules.ts
 function isWebFrontend(value) {
@@ -638,8 +699,16 @@ function splitFrontends(values = []) {
 }
 function ensureSingleWebAndNative(frontends) {
 	const { web, native } = splitFrontends(frontends);
-	if (web.length > 1) exitWithError("Cannot select multiple web frameworks. Choose only one of: tanstack-router, tanstack-start, react-router, next, nuxt, svelte, solid, astro, qwik, angular, redwood, fresh");
-	if (native.length > 1) exitWithError("Cannot select multiple native frameworks. Choose only one of: native-bare, native-uniwind, native-unistyles");
+	if (web.length > 1) invalidSelectionError({
+		message: "Only one web framework can be selected per project.",
+		provided: { frontend: web },
+		suggestions: ["Keep one web framework and remove the others", "Use separate projects for multiple web frameworks"]
+	});
+	if (native.length > 1) invalidSelectionError({
+		message: "Only one native framework can be selected per project.",
+		provided: { frontend: native },
+		suggestions: ["Keep one native framework and remove the others", "Choose: native-bare, native-uniwind, or native-unistyles"]
+	});
 }
 const FULLSTACK_FRONTENDS$1 = [
 	"next",
@@ -663,11 +732,51 @@ const WORKERS_COMPATIBLE_BACKENDS = [
 	"fets"
 ];
 function validateWorkersCompatibility(providedFlags, options, config) {
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && !WORKERS_COMPATIBLE_BACKENDS.includes(config.backend)) exitWithError(`Cloudflare Workers runtime (--runtime workers) is only supported with Hono, Nitro, or feTS backend. Current backend: ${config.backend}. Please use '--backend hono', '--backend nitro', or '--backend fets', or choose a different runtime.`);
-	if (providedFlags.has("backend") && config.backend && !WORKERS_COMPATIBLE_BACKENDS.includes(config.backend) && config.runtime === "workers") exitWithError(`Backend '${config.backend}' is not compatible with Cloudflare Workers runtime. Cloudflare Workers runtime is only supported with Hono, Nitro, or feTS backend. Please use '--backend hono', '--backend nitro', or '--backend fets', 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 or Prisma 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 or Prisma ORM. Please use a different database or runtime.");
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && !WORKERS_COMPATIBLE_BACKENDS.includes(config.backend)) incompatibilityError({
+		message: "Cloudflare Workers runtime requires a compatible backend.",
+		provided: {
+			runtime: "workers",
+			backend: config.backend
+		},
+		suggestions: [
+			"Use --backend hono",
+			"Use --backend nitro",
+			"Use --backend fets",
+			"Choose a different runtime (node, bun)"
+		]
+	});
+	if (providedFlags.has("backend") && config.backend && !WORKERS_COMPATIBLE_BACKENDS.includes(config.backend) && config.runtime === "workers") incompatibilityError({
+		message: `Backend '${config.backend}' is not compatible with Workers runtime.`,
+		provided: {
+			backend: config.backend,
+			runtime: "workers"
+		},
+		suggestions: ["Use --backend hono, --backend nitro, or --backend fets", "Choose a different runtime (node, bun)"]
+	});
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.database === "mongodb") incompatibilityError({
+		message: "Cloudflare Workers runtime is not compatible with MongoDB.",
+		provided: {
+			runtime: "workers",
+			database: "mongodb"
+		},
+		suggestions: ["Use a different database (postgres, sqlite, mysql)", "Choose a different runtime (node, bun)"]
+	});
+	if (providedFlags.has("runtime") && options.runtime === "workers" && config.dbSetup === "docker") incompatibilityError({
+		message: "Cloudflare Workers runtime is not compatible with Docker setup.",
+		provided: {
+			runtime: "workers",
+			"db-setup": "docker"
+		},
+		suggestions: ["Use --db-setup d1 for SQLite", "Choose a different runtime (node, bun)"]
+	});
+	if (providedFlags.has("database") && config.database === "mongodb" && config.runtime === "workers") incompatibilityError({
+		message: "MongoDB is not compatible with Cloudflare Workers runtime.",
+		provided: {
+			database: "mongodb",
+			runtime: "workers"
+		},
+		suggestions: ["Use a different database (postgres, sqlite, mysql)", "Choose a different runtime (node, bun)"]
+	});
 }
 function validateApiFrontendCompatibility(api, frontends = [], astroIntegration) {
 	const includesNuxt = frontends.includes("nuxt");
@@ -678,12 +787,66 @@ function validateApiFrontendCompatibility(api, frontends = [], astroIntegration)
 	const includesAngular = frontends.includes("angular");
 	const includesRedwood = frontends.includes("redwood");
 	const includesFresh = frontends.includes("fresh");
-	if ((includesNuxt || includesSvelte || includesSolid) && (api === "trpc" || api === "ts-rest" || api === "garph")) exitWithError(`${api === "trpc" ? "tRPC" : api === "ts-rest" ? "ts-rest" : "garph"} 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.`);
-	if (includesQwik && api && api !== "none") exitWithError(`Qwik has its own built-in server capabilities and doesn't support external API layers (tRPC/oRPC). Please use --api none with Qwik.`);
-	if (includesAngular && api && api !== "none") exitWithError(`Angular has its own built-in HttpClient and doesn't support external API layers (tRPC/oRPC/ts-rest/garph). Please use --api none with Angular.`);
-	if (includesRedwood && api && api !== "none") exitWithError(`RedwoodJS has its own built-in GraphQL API and doesn't support external API layers (tRPC/oRPC/ts-rest/garph). Please use --api none with RedwoodJS.`);
-	if (includesFresh && api && api !== "none") exitWithError(`Fresh has its own built-in server capabilities (Deno-native) and doesn't support external API layers (tRPC/oRPC/ts-rest/garph). Please use --api none with Fresh.`);
-	if (includesAstro && astroIntegration && astroIntegration !== "react" && (api === "trpc" || api === "ts-rest" || api === "garph")) exitWithError(`${api === "trpc" ? "tRPC" : api === "ts-rest" ? "ts-rest" : "garph"} API requires React integration with Astro. Please use --api orpc or --api none, or use --astro-integration react.`);
+	if ((includesNuxt || includesSvelte || includesSolid) && (api === "trpc" || api === "ts-rest" || api === "garph")) {
+		const apiName = api === "trpc" ? "tRPC" : api === "ts-rest" ? "ts-rest" : "garph";
+		const incompatibleFrontend = includesNuxt ? "nuxt" : includesSvelte ? "svelte" : "solid";
+		incompatibilityError({
+			message: `${apiName} API requires React-based frontends.`,
+			provided: {
+				api,
+				frontend: incompatibleFrontend
+			},
+			suggestions: [
+				"Use --api orpc (works with all frontends)",
+				"Use --api none",
+				"Choose next, react-router, or tanstack-start"
+			]
+		});
+	}
+	if (includesQwik && api && api !== "none") incompatibilityError({
+		message: "Qwik has built-in server capabilities and doesn't support external APIs.",
+		provided: {
+			api,
+			frontend: "qwik"
+		},
+		suggestions: ["Use --api none with Qwik"]
+	});
+	if (includesAngular && api && api !== "none") incompatibilityError({
+		message: "Angular has built-in HttpClient and doesn't support external APIs.",
+		provided: {
+			api,
+			frontend: "angular"
+		},
+		suggestions: ["Use --api none with Angular"]
+	});
+	if (includesRedwood && api && api !== "none") incompatibilityError({
+		message: "RedwoodJS has built-in GraphQL API and doesn't support external APIs.",
+		provided: {
+			api,
+			frontend: "redwood"
+		},
+		suggestions: ["Use --api none with RedwoodJS"]
+	});
+	if (includesFresh && api && api !== "none") incompatibilityError({
+		message: "Fresh has built-in server capabilities and doesn't support external APIs.",
+		provided: {
+			api,
+			frontend: "fresh"
+		},
+		suggestions: ["Use --api none with Fresh"]
+	});
+	if (includesAstro && astroIntegration && astroIntegration !== "react" && (api === "trpc" || api === "ts-rest" || api === "garph")) incompatibilityError({
+		message: `${api === "trpc" ? "tRPC" : api === "ts-rest" ? "ts-rest" : "garph"} API requires React integration with Astro.`,
+		provided: {
+			api,
+			"astro-integration": astroIntegration
+		},
+		suggestions: [
+			"Use --api orpc (works with all Astro integrations)",
+			"Use --api none",
+			"Use --astro-integration react"
+		]
+	});
 }
 function isFrontendAllowedWithBackend(frontend, backend, auth) {
 	if (backend === "convex" && frontend === "solid") return false;
@@ -817,10 +980,27 @@ function validateUILibraryFrontendCompatibility(uiLibrary, frontends = [], astro
 				"next"
 			].includes(f))) return;
 		}
-		if (!compatibility.frontends.includes("astro")) exitWithError(`UI library '${uiLibrary}' requires React. Astro is configured with '${astroIntegration || "none"}' integration. Please use --astro-integration react or choose a different UI library (e.g., daisyui, ark-ui).`);
+		if (!compatibility.frontends.includes("astro")) {
+			const integrationName = astroIntegration || "none";
+			incompatibilityError({
+				message: `UI library '${uiLibrary}' requires React.`,
+				provided: {
+					"ui-library": uiLibrary,
+					"astro-integration": integrationName
+				},
+				suggestions: ["Use --astro-integration react", "Choose a different UI library (daisyui, ark-ui)"]
+			});
+		}
 		return;
 	}
-	if (!compatibility.frontends.includes(webFrontend)) exitWithError(`UI library '${uiLibrary}' is not compatible with '${webFrontend}' frontend. Supported frontends: ${compatibility.frontends.join(", ")}`);
+	if (!compatibility.frontends.includes(webFrontend)) incompatibilityError({
+		message: `UI library '${uiLibrary}' is not compatible with '${webFrontend}'.`,
+		provided: {
+			"ui-library": uiLibrary,
+			frontend: webFrontend
+		},
+		suggestions: [`Supported frontends: ${compatibility.frontends.join(", ")}`, "Choose a different UI library"]
+	});
 }
 /**
 * Validates that a UI library is compatible with the selected CSS framework
@@ -3674,21 +3854,244 @@ function validateArrayOptions(options) {
 	validateNoneExclusivity(options.examples, "examples");
 }
 
+//#endregion
+//#region src/utils/peer-dependency-conflicts.ts
+/**
+* Known peer dependency conflicts.
+*
+* Add new conflicts here as they are discovered.
+* The validator will check these against the user's selected options.
+*/
+const PEER_DEPENDENCY_CONFLICTS = [
+	{
+		id: "redux-toolkit-react19",
+		description: "redux-toolkit with React 19 may have peer dependency warnings",
+		packages: ["@reduxjs/toolkit", "react-redux"],
+		severity: "warning",
+		resolution: "Consider using zustand or jotai for React 19 projects, or ensure react-redux v9+",
+		triggeredBy: [{
+			optionKey: "stateManagement",
+			values: ["redux-toolkit"]
+		}],
+		conflictsWithOptions: [{
+			optionKey: "frontend",
+			values: ["next"]
+		}]
+	},
+	{
+		id: "effect-schema-zod-overlap",
+		description: "@effect/schema and zod both provide validation - may cause confusion",
+		packages: ["@effect/schema", "zod"],
+		severity: "warning",
+		resolution: "Use --validation effect-schema with Effect, or --effect none with Zod",
+		triggeredBy: [{
+			optionKey: "effect",
+			values: ["effect-full"]
+		}],
+		conflictsWithOptions: [{
+			optionKey: "validation",
+			values: ["zod"]
+		}]
+	},
+	{
+		id: "prisma-d1-version",
+		description: "Prisma with D1 requires Prisma 5.x+ and specific adapter setup",
+		packages: ["prisma", "@prisma/adapter-d1"],
+		severity: "warning",
+		resolution: "Consider Drizzle ORM for simpler D1 integration",
+		triggeredBy: [{
+			optionKey: "orm",
+			values: ["prisma"]
+		}],
+		conflictsWithOptions: [{
+			optionKey: "dbSetup",
+			values: ["d1"]
+		}]
+	},
+	{
+		id: "biome-linting-overlap",
+		description: "Biome includes linting/formatting - other linting addons are redundant",
+		packages: [
+			"@biomejs/biome",
+			"eslint",
+			"prettier"
+		],
+		severity: "warning",
+		resolution: "Choose either Biome (all-in-one) or other linting tools, not both",
+		triggeredBy: [{
+			optionKey: "addons",
+			values: ["biome"]
+		}],
+		conflictsWithOptions: [{
+			optionKey: "addons",
+			values: ["ultracite", "oxlint"]
+		}]
+	},
+	{
+		id: "framer-motion-react19",
+		description: "framer-motion versions <12 may have React 19 issues",
+		packages: ["framer-motion"],
+		severity: "warning",
+		resolution: "The CLI uses motion (framer-motion v12+) which supports React 19",
+		triggeredBy: [{
+			optionKey: "animation",
+			values: ["framer-motion"]
+		}],
+		conflictsWithOptions: [{
+			optionKey: "frontend",
+			values: ["next"]
+		}]
+	}
+];
+
+//#endregion
+//#region src/utils/peer-dependency-validator.ts
+/**
+* Peer dependency conflict validator.
+*
+* Checks project configuration against known conflicts and provides
+* warnings or errors before project creation begins.
+*/
+/**
+* Checks if a config value matches any of the specified values.
+*/
+function matchesValue(configValue, values) {
+	if (configValue === void 0 || configValue === null) return false;
+	if (Array.isArray(configValue)) return values.some((v) => configValue.includes(v));
+	return values.includes(configValue);
+}
+/**
+* Checks the configuration against known peer dependency conflicts.
+*/
+function checkPeerDependencyConflicts(config) {
+	const errors = [];
+	const warnings = [];
+	for (const conflict of PEER_DEPENDENCY_CONFLICTS) {
+		if (!conflict.triggeredBy.some((trigger) => {
+			const configValue = config[trigger.optionKey];
+			return matchesValue(configValue, trigger.values);
+		})) continue;
+		if (conflict.conflictsWithOptions.some((opt) => {
+			const configValue = config[opt.optionKey];
+			return matchesValue(configValue, opt.values);
+		})) if (conflict.severity === "error") errors.push(conflict);
+		else warnings.push(conflict);
+	}
+	return {
+		errors,
+		warnings
+	};
+}
+/**
+* Prints a warning message for a dependency conflict.
+*/
+function warnDependencyConflict(message, resolution) {
+	if (isSilent()) return;
+	consola.warn(pc.yellow(`Peer Dependency Warning: ${message}`));
+	consola.log(pc.dim(`   → ${resolution}`));
+}
+/**
+* Handles conflict results by printing warnings and exiting on errors.
+*/
+function handleConflictResult(result) {
+	for (const warning of result.warnings) warnDependencyConflict(warning.description, warning.resolution);
+	if (result.errors.length > 0) exitWithError(`Peer Dependency Conflict:\n${result.errors.map((e) => `${e.description}\n   → ${e.resolution}`).join("\n\n")}`);
+}
+/**
+* Validates peer dependencies for the given configuration.
+* Prints warnings and exits on errors.
+*/
+function validatePeerDependencies(config) {
+	handleConflictResult(checkPeerDependencyConflicts(config));
+}
+
 //#endregion
 //#region src/utils/config-validation.ts
 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") exitWithError("Mongoose ORM requires MongoDB database. Please use '--database mongodb' or choose a different ORM.");
-	if (has("orm") && has("database") && orm === "drizzle" && db === "mongodb") exitWithError("Drizzle ORM does not support MongoDB. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
-	if (has("orm") && has("database") && orm === "typeorm" && db === "mongodb") exitWithError("TypeORM does not support MongoDB in Better Fullstack. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
-	if (has("orm") && has("database") && orm === "kysely" && db === "mongodb") exitWithError("Kysely does not support MongoDB. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
-	if (has("orm") && has("database") && orm === "mikroorm" && db === "mongodb") exitWithError("MikroORM does not support MongoDB in Better Fullstack. Please use '--orm mongoose' or '--orm prisma' or choose a different database.");
-	if (has("orm") && has("database") && orm === "sequelize" && db === "mongodb") exitWithError("Sequelize 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") exitWithError("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") exitWithError("Database selection requires an ORM. Please choose '--orm drizzle', '--orm prisma', '--orm typeorm', '--orm kysely', '--orm mikroorm', '--orm sequelize', or '--orm mongoose'.");
-	if (has("orm") && has("database") && orm && orm !== "none" && db === "none") exitWithError("ORM selection requires a database. Please choose a database or set '--orm none'.");
+	if (has("orm") && has("database") && orm === "mongoose" && db !== "mongodb") incompatibilityError({
+		message: "Mongoose ORM requires MongoDB database.",
+		provided: {
+			orm: "mongoose",
+			database: db || "none"
+		},
+		suggestions: ["Use --database mongodb", "Choose a different ORM (drizzle, prisma)"]
+	});
+	if (has("orm") && has("database") && orm === "drizzle" && db === "mongodb") incompatibilityError({
+		message: "Drizzle ORM does not support MongoDB.",
+		provided: {
+			orm: "drizzle",
+			database: "mongodb"
+		},
+		suggestions: ["Use --orm mongoose or --orm prisma for MongoDB", "Choose a different database (postgres, sqlite, mysql)"]
+	});
+	if (has("orm") && has("database") && orm === "typeorm" && db === "mongodb") incompatibilityError({
+		message: "TypeORM does not support MongoDB in Better Fullstack.",
+		provided: {
+			orm: "typeorm",
+			database: "mongodb"
+		},
+		suggestions: ["Use --orm mongoose or --orm prisma for MongoDB", "Choose a different database (postgres, sqlite, mysql)"]
+	});
+	if (has("orm") && has("database") && orm === "kysely" && db === "mongodb") incompatibilityError({
+		message: "Kysely does not support MongoDB.",
+		provided: {
+			orm: "kysely",
+			database: "mongodb"
+		},
+		suggestions: ["Use --orm mongoose or --orm prisma for MongoDB", "Choose a different database (postgres, sqlite, mysql)"]
+	});
+	if (has("orm") && has("database") && orm === "mikroorm" && db === "mongodb") incompatibilityError({
+		message: "MikroORM does not support MongoDB in Better Fullstack.",
+		provided: {
+			orm: "mikroorm",
+			database: "mongodb"
+		},
+		suggestions: ["Use --orm mongoose or --orm prisma for MongoDB", "Choose a different database (postgres, sqlite, mysql)"]
+	});
+	if (has("orm") && has("database") && orm === "sequelize" && db === "mongodb") incompatibilityError({
+		message: "Sequelize does not support MongoDB.",
+		provided: {
+			orm: "sequelize",
+			database: "mongodb"
+		},
+		suggestions: ["Use --orm mongoose or --orm prisma for MongoDB", "Choose a different database (postgres, sqlite, mysql)"]
+	});
+	if (has("database") && has("orm") && db === "mongodb" && orm && orm !== "mongoose" && orm !== "prisma" && orm !== "none") incompatibilityError({
+		message: "MongoDB only works with Mongoose or Prisma ORM.",
+		provided: {
+			database: "mongodb",
+			orm
+		},
+		suggestions: ["Use --orm mongoose", "Use --orm prisma"]
+	});
+	if (has("database") && has("orm") && db && db !== "none" && orm === "none") missingRequirementError({
+		message: "Database selection requires an ORM.",
+		provided: {
+			database: db,
+			orm: "none"
+		},
+		suggestions: [
+			"Use --orm drizzle (recommended)",
+			"Use --orm prisma",
+			"Use --orm mongoose (MongoDB only)"
+		]
+	});
+	if (has("orm") && has("database") && orm && orm !== "none" && db === "none") missingRequirementError({
+		message: "ORM selection requires a database.",
+		provided: {
+			orm,
+			database: "none"
+		},
+		suggestions: [
+			"Use --database postgres",
+			"Use --database sqlite",
+			"Use --database mysql",
+			"Set --orm none"
+		]
+	});
 }
 function validateDatabaseSetup(config, providedFlags) {
 	const { dbSetup, database, runtime } = config;
@@ -3739,12 +4142,54 @@ function validateConvexConstraints(config, providedFlags) {
 	const { backend } = config;
 	if (backend !== "convex") return;
 	const has = (k) => providedFlags.has(k);
-	if (has("runtime") && config.runtime !== "none") exitWithError("Convex backend requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
-	if (has("database") && config.database !== "none") exitWithError("Convex backend requires '--database none'. Please remove the --database flag or set it to 'none'.");
-	if (has("orm") && config.orm !== "none") exitWithError("Convex backend requires '--orm none'. Please remove the --orm flag or set it to 'none'.");
-	if (has("api") && config.api !== "none") exitWithError("Convex backend requires '--api none'. Please remove the --api flag or set it to 'none'.");
-	if (has("dbSetup") && config.dbSetup !== "none") exitWithError("Convex backend requires '--db-setup none'. Please remove the --db-setup flag or set it to 'none'.");
-	if (has("serverDeploy") && config.serverDeploy !== "none") exitWithError("Convex backend requires '--server-deploy none'. Please remove the --server-deploy flag or set it to 'none'.");
+	if (has("runtime") && config.runtime !== "none") constraintError({
+		message: "Convex backend manages its own runtime.",
+		provided: {
+			backend: "convex",
+			runtime: config.runtime || ""
+		},
+		suggestions: ["Remove --runtime flag", "Set --runtime none"]
+	});
+	if (has("database") && config.database !== "none") constraintError({
+		message: "Convex backend has its own built-in database.",
+		provided: {
+			backend: "convex",
+			database: config.database || ""
+		},
+		suggestions: ["Remove --database flag", "Set --database none"]
+	});
+	if (has("orm") && config.orm !== "none") constraintError({
+		message: "Convex backend has its own data layer (no ORM needed).",
+		provided: {
+			backend: "convex",
+			orm: config.orm || ""
+		},
+		suggestions: ["Remove --orm flag", "Set --orm none"]
+	});
+	if (has("api") && config.api !== "none") constraintError({
+		message: "Convex backend has its own built-in API layer.",
+		provided: {
+			backend: "convex",
+			api: config.api || ""
+		},
+		suggestions: ["Remove --api flag", "Set --api none"]
+	});
+	if (has("dbSetup") && config.dbSetup !== "none") constraintError({
+		message: "Convex backend manages its own database infrastructure.",
+		provided: {
+			backend: "convex",
+			"db-setup": config.dbSetup || ""
+		},
+		suggestions: ["Remove --db-setup flag", "Set --db-setup none"]
+	});
+	if (has("serverDeploy") && config.serverDeploy !== "none") constraintError({
+		message: "Convex backend has its own deployment platform.",
+		provided: {
+			backend: "convex",
+			"server-deploy": config.serverDeploy || ""
+		},
+		suggestions: ["Remove --server-deploy flag", "Set --server-deploy none"]
+	});
 	if (has("auth") && config.auth === "better-auth") {
 		const supportedFrontends = [
 			"tanstack-router",
@@ -3754,7 +4199,20 @@ function validateConvexConstraints(config, providedFlags) {
 			"native-uniwind",
 			"native-unistyles"
 		];
-		if (!config.frontend?.some((f) => supportedFrontends.includes(f))) exitWithError("Better-Auth with Convex backend requires a supported frontend (TanStack Router, TanStack Start, Next.js, or Native).");
+		if (!config.frontend?.some((f) => supportedFrontends.includes(f))) incompatibilityError({
+			message: "Better-Auth with Convex requires specific frontends.",
+			provided: {
+				backend: "convex",
+				auth: "better-auth",
+				frontend: config.frontend || []
+			},
+			suggestions: [
+				"Use --frontend tanstack-router",
+				"Use --frontend tanstack-start",
+				"Use --frontend next",
+				"Use a native frontend"
+			]
+		});
 	}
 }
 function validateBackendNoneConstraints(config, providedFlags) {
@@ -3851,6 +4309,7 @@ function validateFullConfig(config, providedFlags, options) {
 	validateNextAuthCompatibility(config.auth, config.backend, config.frontend ?? []);
 	validateUILibraryFrontendCompatibility(config.uiLibrary, config.frontend ?? [], config.astroIntegration);
 	validateUILibraryCSSFrameworkCompatibility(config.uiLibrary, config.cssFramework);
+	validatePeerDependencies(config);
 }
 function validateConfigForProgrammaticUse(config) {
 	try {
@@ -3863,6 +4322,7 @@ function validateConfigForProgrammaticUse(config) {
 		validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
 		validateUILibraryFrontendCompatibility(config.uiLibrary, config.frontend ?? [], config.astroIntegration);
 		validateUILibraryCSSFrameworkCompatibility(config.uiLibrary, config.cssFramework);
+		validatePeerDependencies(config);
 	} catch (error) {
 		if (error instanceof Error) throw error;
 		throw new Error(String(error));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-fullstack",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "A CLI-first toolkit for building Full Stack applications. Skip the configuration. Ship the code.",
   "keywords": [
     "better-auth",
@@ -64,17 +64,20 @@
     "dev": "tsdown --watch",
     "lint": "oxlint . && tsc --noEmit && bun test test/cli-builder-sync.test.ts",
     "check-types": "tsc --noEmit",
-    "test": "bun test",
+    "test": "bun test ./test/*.test.ts",
     "test:watch": "bun test --watch",
     "test:coverage": "bun test --coverage",
     "test:ci": "CI=1 bun test --bail=5",
     "test:e2e": "E2E=1 bun test test/e2e/e2e.e2e.ts",
     "test:astro-combos": "bun run scripts/test-astro-combinations.ts",
+    "test:matrix": "MATRIX_MODE=batched bun test ./test/matrix/matrix-test.test.ts",
+    "test:matrix:fast": "MATRIX_MODE=sample MATRIX_SAMPLE=0.1 bun test ./test/matrix/matrix-test.test.ts",
+    "test:matrix:full": "MATRIX_MODE=full bun test ./test/matrix/matrix-test.test.ts",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-fullstack/template-generator": "^1.1.9",
-    "@better-fullstack/types": "^1.1.9",
+    "@better-fullstack/template-generator": "^1.1.11",
+    "@better-fullstack/types": "^1.1.11",
     "@clack/core": "^0.5.0",
     "@clack/prompts": "^1.0.0-alpha.8",
     "@orpc/server": "^1.13.0",