create-better-t-stack 3.17.1 → 3.18.0

package/dist/{src-D5L84uxt.mjs → src-R2RWz37j.mjs}

@@ -2,6 +2,7 @@
 import { t as __reExport } from "./chunk-DPg_XC7m.mjs";
 import { autocompleteMultiselect, cancel, confirm, group, intro, isCancel, log, multiselect, outro, select, spinner, text } from "@clack/prompts";
 import { createRouterClient, os } from "@orpc/server";
+import { Result, Result as Result$1, TaggedError } from "better-result";
 import pc from "picocolors";
 import { createCli } from "trpc-cli";
 import z from "zod";
@@ -9,11 +10,11 @@ import consola, { consola as consola$1 } from "consola";
 import fs from "fs-extra";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { EMBEDDED_TEMPLATES, EMBEDDED_TEMPLATES as EMBEDDED_TEMPLATES$1, TEMPLATE_COUNT, VirtualFileSystem, dependencyVersionMap, generateVirtualProject, generateVirtualProject as generateVirtualProject$1 } from "@better-t-stack/template-generator";
-import { AsyncLocalStorage } from "node:async_hooks";
+import { EMBEDDED_TEMPLATES, EMBEDDED_TEMPLATES as EMBEDDED_TEMPLATES$1, GeneratorError, GeneratorError as GeneratorError$1, TEMPLATE_COUNT, VirtualFileSystem, dependencyVersionMap, generate, generate as generate$1 } from "@better-t-stack/template-generator";
 import { ConfirmPrompt, GroupMultiSelectPrompt, MultiSelectPrompt, SelectPrompt, isCancel as isCancel$1 } from "@clack/core";
+import { AsyncLocalStorage } from "node:async_hooks";
 import gradient from "gradient-string";
-import { writeTreeToFilesystem } from "@better-t-stack/template-generator/fs-writer";
+import { writeTree } from "@better-t-stack/template-generator/fs-writer";
 import { $, execa } from "execa";
 import * as JSONC from "jsonc-parser";
 import { format } from "oxfmt";
@@ -91,88 +92,93 @@ const ADDON_COMPATIBILITY = {
 	none: []
 };
 
-//#endregion
-//#region src/utils/context.ts
-const cliStorage = new AsyncLocalStorage();
-function defaultContext() {
-	return {
-		navigation: {
-			isFirstPrompt: false,
-			lastPromptShownUI: false
-		},
-		silent: false,
-		verbose: false
-	};
-}
-function getContext() {
-	const ctx = cliStorage.getStore();
-	if (!ctx) return defaultContext();
-	return ctx;
-}
-function tryGetContext() {
-	return cliStorage.getStore();
-}
-function isSilent() {
-	return getContext().silent;
-}
-function isFirstPrompt() {
-	return getContext().navigation.isFirstPrompt;
-}
-function didLastPromptShowUI() {
-	return getContext().navigation.lastPromptShownUI;
-}
-function setIsFirstPrompt$1(value) {
-	const ctx = tryGetContext();
-	if (ctx) ctx.navigation.isFirstPrompt = value;
-}
-function setLastPromptShownUI(value) {
-	const ctx = tryGetContext();
-	if (ctx) ctx.navigation.lastPromptShownUI = value;
-}
-async function runWithContextAsync(options, fn) {
-	const ctx = {
-		navigation: {
-			isFirstPrompt: false,
-			lastPromptShownUI: false
-		},
-		silent: options.silent ?? false,
-		verbose: options.verbose ?? false,
-		projectDir: options.projectDir,
-		projectName: options.projectName,
-		packageManager: options.packageManager
-	};
-	return cliStorage.run(ctx, fn);
-}
-
 //#endregion
 //#region src/utils/errors.ts
-var UserCancelledError = class extends Error {
-	constructor(message = "Operation cancelled") {
-		super(message);
-		this.name = "UserCancelledError";
+/**
+* User cancelled the operation (e.g., Ctrl+C in prompts)
+*/
+var UserCancelledError = class extends TaggedError("UserCancelledError")() {
+	constructor(args) {
+		super({ message: args?.message ?? "Operation cancelled" });
+	}
+};
+/**
+* General CLI error for validation failures, invalid flags, etc.
+*/
+var CLIError = class extends TaggedError("CLIError")() {};
+/**
+* Validation error for config/flag validation failures
+*/
+var ValidationError = class extends TaggedError("ValidationError")() {
+	constructor(args) {
+		super(args);
+	}
+};
+/**
+* Compatibility error for incompatible option combinations
+*/
+var CompatibilityError = class extends TaggedError("CompatibilityError")() {
+	constructor(args) {
+		super(args);
+	}
+};
+/**
+* Directory conflict error when target directory exists and is not empty
+*/
+var DirectoryConflictError = class extends TaggedError("DirectoryConflictError")() {
+	constructor(args) {
+		super({
+			directory: args.directory,
+			message: `Directory "${args.directory}" already exists and is not empty. Use directoryConflict: "overwrite", "merge", or "increment" to handle this.`
+		});
+	}
+};
+/**
+* Project creation error for failures during scaffolding
+*/
+var ProjectCreationError = class extends TaggedError("ProjectCreationError")() {
+	constructor(args) {
+		super(args);
+	}
+};
+/**
+* Database setup error for failures during database configuration
+*/
+var DatabaseSetupError = class extends TaggedError("DatabaseSetupError")() {
+	constructor(args) {
+		super(args);
 	}
 };
-var CLIError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "CLIError";
+/**
+* Addon setup error for failures during addon configuration
+*/
+var AddonSetupError = class extends TaggedError("AddonSetupError")() {
+	constructor(args) {
+		super(args);
 	}
 };
-function exitWithError(message) {
-	if (isSilent()) throw new CLIError(message);
-	consola.error(pc.red(message));
-	process.exit(1);
-}
-function exitCancelled(message = "Operation cancelled") {
-	if (isSilent()) throw new UserCancelledError(message);
-	cancel(pc.red(message));
-	process.exit(1);
-}
-function handleError(error, fallbackMessage) {
-	const message = error instanceof Error ? error.message : fallbackMessage || String(error);
-	if (isSilent()) throw error instanceof Error ? error : new Error(message);
-	consola.error(pc.red(message));
-	process.exit(1);
+/**
+* Create a user cancelled error Result
+*/
+function userCancelled(message) {
+	return Result.err(new UserCancelledError({ message }));
+}
+/**
+* Create a database setup error Result
+*/
+function databaseSetupError(provider, message, cause) {
+	return Result.err(new DatabaseSetupError({
+		provider,
+		message,
+		cause
+	}));
+}
+/**
+* Display an error to the user (for CLI mode)
+*/
+function displayError(error) {
+	if (UserCancelledError.is(error)) cancel(pc.red(error.message));
+	else consola.error(pc.red(error.message));
 }
 
 //#endregion
@@ -196,6 +202,9 @@ const WEB_FRAMEWORKS = [
 
 //#endregion
 //#region src/utils/compatibility-rules.ts
+function validationErr$1(message) {
+	return Result.err(new ValidationError({ message }));
+}
 function isWebFrontend(value) {
 	return WEB_FRAMEWORKS.includes(value);
 }
@@ -207,8 +216,9 @@ 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");
-	if (native.length > 1) exitWithError("Cannot select multiple native frameworks. Choose only one of: native-bare, native-uniwind, native-unistyles");
+	if (web.length > 1) return validationErr$1("Cannot select multiple web frameworks. Choose only one of: tanstack-router, tanstack-start, react-router, next, nuxt, svelte, solid");
+	if (native.length > 1) return validationErr$1("Cannot select multiple native frameworks. Choose only one of: native-bare, native-uniwind, native-unistyles");
+	return Result.ok(void 0);
 }
 const FULLSTACK_FRONTENDS$1 = [
 	"next",
@@ -221,25 +231,28 @@ function validateSelfBackendCompatibility(providedFlags, options, config) {
 	const frontends = config.frontend || options.frontend || [];
 	if (backend === "self") {
 		const { web, native } = splitFrontends(frontends);
-		if (!(web.length === 1 && FULLSTACK_FRONTENDS$1.includes(web[0]))) exitWithError("Backend 'self' (fullstack) currently only supports Next.js, TanStack Start, Nuxt, and Astro frontends. Please use --frontend next, --frontend tanstack-start, --frontend nuxt, or --frontend astro. Support for SvelteKit will be added in a future update.");
-		if (native.length > 1) exitWithError("Cannot select multiple native frameworks. Choose only one of: native-bare, native-uniwind, native-unistyles");
+		if (!(web.length === 1 && FULLSTACK_FRONTENDS$1.includes(web[0]))) return validationErr$1("Backend 'self' (fullstack) currently only supports Next.js, TanStack Start, Nuxt, and Astro frontends. Please use --frontend next, --frontend tanstack-start, --frontend nuxt, or --frontend astro. Support for SvelteKit will be added in a future update.");
+		if (native.length > 1) return validationErr$1("Cannot select multiple native frameworks. Choose only one of: native-bare, native-uniwind, native-unistyles");
 	}
 	const hasFullstackFrontend = frontends.some((f) => FULLSTACK_FRONTENDS$1.includes(f));
-	if (providedFlags.has("backend") && !hasFullstackFrontend && backend === "self") exitWithError("Backend 'self' (fullstack) currently only supports Next.js, TanStack Start, Nuxt, and Astro frontends. Please use --frontend next, --frontend tanstack-start, --frontend nuxt, --frontend astro, or choose a different backend. Support for SvelteKit will be added in a future update.");
+	if (providedFlags.has("backend") && !hasFullstackFrontend && backend === "self") return validationErr$1("Backend 'self' (fullstack) currently only supports Next.js, TanStack Start, Nuxt, and Astro frontends. Please use --frontend next, --frontend tanstack-start, --frontend nuxt, --frontend astro, or choose a different backend. Support for SvelteKit will be added in a future update.");
+	return Result.ok(void 0);
 }
 function validateWorkersCompatibility(providedFlags, options, config) {
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.backend && config.backend !== "hono") exitWithError(`Cloudflare Workers runtime (--runtime workers) is only supported with Hono backend (--backend hono). Current backend: ${config.backend}. Please use '--backend hono' or choose a different runtime.`);
-	if (providedFlags.has("backend") && config.backend && config.backend !== "hono" && config.runtime === "workers") exitWithError(`Backend '${config.backend}' is not compatible with Cloudflare Workers runtime. Cloudflare Workers runtime is only supported with Hono backend. Please use '--backend hono' or choose a different runtime.`);
-	if (providedFlags.has("runtime") && options.runtime === "workers" && config.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 && 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);
 }
 function validateApiFrontendCompatibility(api, frontends = []) {
 	const includesNuxt = frontends.includes("nuxt");
 	const includesSvelte = frontends.includes("svelte");
 	const includesSolid = frontends.includes("solid");
 	const includesAstro = frontends.includes("astro");
-	if ((includesNuxt || includesSvelte || includesSolid || includesAstro) && api === "trpc") exitWithError(`tRPC API is not supported with '${includesNuxt ? "nuxt" : includesSvelte ? "svelte" : includesSolid ? "solid" : "astro"}' frontend. Please use --api orpc or --api none or remove '${includesNuxt ? "nuxt" : includesSvelte ? "svelte" : includesSolid ? "solid" : "astro"}' from --frontend.`);
+	if ((includesNuxt || includesSvelte || includesSolid || includesAstro) && api === "trpc") return validationErr$1(`tRPC API is not supported with '${includesNuxt ? "nuxt" : includesSvelte ? "svelte" : includesSolid ? "solid" : "astro"}' frontend. Please use --api orpc or --api none or remove '${includesNuxt ? "nuxt" : includesSvelte ? "svelte" : includesSolid ? "solid" : "astro"}' from --frontend.`);
+	return Result.ok(void 0);
 }
 function isFrontendAllowedWithBackend(frontend, backend, auth) {
 	if (backend === "convex" && (frontend === "solid" || frontend === "astro")) return false;
@@ -283,10 +296,12 @@ function isExampleAIAllowed(backend, frontends = []) {
 	return true;
 }
 function validateWebDeployRequiresWebFrontend(webDeploy, hasWebFrontendFlag) {
-	if (webDeploy && webDeploy !== "none" && !hasWebFrontendFlag) exitWithError("'--web-deploy' requires a web frontend. Please select a web frontend or set '--web-deploy none'.");
+	if (webDeploy && webDeploy !== "none" && !hasWebFrontendFlag) return validationErr$1("'--web-deploy' requires a web frontend. Please select a web frontend or set '--web-deploy none'.");
+	return Result.ok(void 0);
 }
 function validateServerDeployRequiresBackend(serverDeploy, backend) {
-	if (serverDeploy && serverDeploy !== "none" && (!backend || backend === "none")) exitWithError("'--server-deploy' requires a backend. Please select a backend or set '--server-deploy none'.");
+	if (serverDeploy && serverDeploy !== "none" && (!backend || backend === "none")) return validationErr$1("'--server-deploy' requires a backend. Please select a backend or set '--server-deploy none'.");
+	return Result.ok(void 0);
 }
 function validateAddonCompatibility(addon, frontend, _auth) {
 	const compatibleFrontends = ADDON_COMPATIBILITY[addon];
@@ -302,31 +317,87 @@ function validateAddonsAgainstFrontends(addons = [], frontends = [], auth) {
 	for (const addon of addons) {
 		if (addon === "none") continue;
 		const { isCompatible, reason } = validateAddonCompatibility(addon, frontends, auth);
-		if (!isCompatible) exitWithError(`Incompatible addon/frontend combination: ${reason}`);
+		if (!isCompatible) return validationErr$1(`Incompatible addon/frontend combination: ${reason}`);
 	}
+	return Result.ok(void 0);
 }
 function validatePaymentsCompatibility(payments, auth, _backend, frontends = []) {
-	if (!payments || payments === "none") return;
+	if (!payments || payments === "none") return Result.ok(void 0);
 	if (payments === "polar") {
-		if (!auth || auth === "none" || auth !== "better-auth") exitWithError("Polar payments requires Better Auth. Please use '--auth better-auth' or choose a different payments provider.");
+		if (!auth || auth === "none" || auth !== "better-auth") return validationErr$1("Polar payments requires Better Auth. Please use '--auth better-auth' or choose a different payments provider.");
 		const { web } = splitFrontends(frontends);
-		if (web.length === 0 && frontends.length > 0) exitWithError("Polar payments requires a web frontend or no frontend. Please select a web frontend or choose a different payments provider.");
+		if (web.length === 0 && frontends.length > 0) return validationErr$1("Polar payments requires a web frontend or no frontend. Please select a web frontend or choose a different payments provider.");
 	}
+	return Result.ok(void 0);
 }
 function validateExamplesCompatibility(examples, backend, database, frontend, api) {
 	const examplesArr = examples ?? [];
-	if (examplesArr.length === 0 || examplesArr.includes("none")) return;
+	if (examplesArr.length === 0 || examplesArr.includes("none")) return Result.ok(void 0);
 	if (examplesArr.includes("todo") && backend !== "convex") {
-		if (database === "none") exitWithError("The 'todo' example requires a database. Cannot use --examples todo when database is 'none'.");
-		if (api === "none") exitWithError("The 'todo' example requires an API layer (tRPC or oRPC). Cannot use --examples todo when api is 'none'.");
+		if (database === "none") return validationErr$1("The 'todo' example requires a database. Cannot use --examples todo when database is 'none'.");
+		if (api === "none") return validationErr$1("The 'todo' example requires an API layer (tRPC or oRPC). Cannot use --examples todo when api is 'none'.");
 	}
-	if (examplesArr.includes("ai") && (frontend ?? []).includes("solid")) exitWithError("The 'ai' example is not compatible with the Solid frontend.");
+	if (examplesArr.includes("ai") && (frontend ?? []).includes("solid")) return validationErr$1("The 'ai' example is not compatible with the Solid frontend.");
 	if (examplesArr.includes("ai") && backend === "convex") {
 		const frontendArr = frontend ?? [];
 		const includesNuxt = frontendArr.includes("nuxt");
 		const includesSvelte = frontendArr.includes("svelte");
-		if (includesNuxt || includesSvelte) exitWithError("The 'ai' example with Convex backend only supports React-based frontends (Next.js, TanStack Router, TanStack Start, React Router). Svelte and Nuxt are not supported with Convex AI.");
+		if (includesNuxt || includesSvelte) return validationErr$1("The 'ai' example with Convex backend only supports React-based frontends (Next.js, TanStack Router, TanStack Start, React Router). Svelte and Nuxt are not supported with Convex AI.");
 	}
+	return Result.ok(void 0);
+}
+
+//#endregion
+//#region src/utils/context.ts
+const cliStorage = new AsyncLocalStorage();
+function defaultContext() {
+	return {
+		navigation: {
+			isFirstPrompt: false,
+			lastPromptShownUI: false
+		},
+		silent: false,
+		verbose: false
+	};
+}
+function getContext() {
+	const ctx = cliStorage.getStore();
+	if (!ctx) return defaultContext();
+	return ctx;
+}
+function tryGetContext() {
+	return cliStorage.getStore();
+}
+function isSilent() {
+	return getContext().silent;
+}
+function isFirstPrompt() {
+	return getContext().navigation.isFirstPrompt;
+}
+function didLastPromptShowUI() {
+	return getContext().navigation.lastPromptShownUI;
+}
+function setIsFirstPrompt$1(value) {
+	const ctx = tryGetContext();
+	if (ctx) ctx.navigation.isFirstPrompt = value;
+}
+function setLastPromptShownUI(value) {
+	const ctx = tryGetContext();
+	if (ctx) ctx.navigation.lastPromptShownUI = value;
+}
+async function runWithContextAsync(options, fn) {
+	const ctx = {
+		navigation: {
+			isFirstPrompt: false,
+			lastPromptShownUI: false
+		},
+		silent: options.silent ?? false,
+		verbose: options.verbose ?? false,
+		projectDir: options.projectDir,
+		projectName: options.projectName,
+		packageManager: options.packageManager
+	};
+	return cliStorage.run(ctx, fn);
 }
 
 //#endregion
@@ -684,7 +755,7 @@ async function getAddonsChoice(addons, frontends, auth) {
 		initialValues: DEFAULT_CONFIG.addons.filter((addonValue) => Object.values(groupedOptions).some((options) => options.some((opt) => opt.value === addonValue))),
 		required: false
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -712,7 +783,7 @@ async function getApiChoice(Api, frontend, backend) {
 		options: apiOptions,
 		initialValue: apiOptions[0].value
 	});
-	if (isCancel$1(apiType)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(apiType)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return apiType;
 }
 
@@ -761,7 +832,7 @@ async function getAuthChoice(auth, backend, frontend) {
 			options,
 			initialValue: "none"
 		});
-		if (isCancel$1(response$1)) return exitCancelled("Operation cancelled");
+		if (isCancel$1(response$1)) throw new UserCancelledError({ message: "Operation cancelled" });
 		return response$1;
 	}
 	const response = await navigableSelect({
@@ -776,7 +847,7 @@ async function getAuthChoice(auth, backend, frontend) {
 		}],
 		initialValue: DEFAULT_CONFIG.auth
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -830,7 +901,7 @@ async function getBackendFrameworkChoice(backendFramework, frontends) {
 		options: backendOptions,
 		initialValue: hasFullstackFrontend ? "self" : DEFAULT_CONFIG.backend
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -871,7 +942,7 @@ async function getDatabaseChoice(database, backend, runtime) {
 		options: databaseOptions,
 		initialValue: DEFAULT_CONFIG.database
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -971,7 +1042,7 @@ async function getDBSetupChoice(databaseType, dbSetup, _orm, backend, runtime) {
 		options,
 		initialValue: "none"
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -999,7 +1070,7 @@ async function getExamplesChoice(examples, database, frontends, backend, api) {
 		required: false,
 		initialValues: DEFAULT_CONFIG.examples?.filter((ex) => options.some((o) => o.value === ex))
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -1024,7 +1095,7 @@ async function getFrontendChoice(frontendOptions, backend, auth) {
 			initialValues: ["web"]
 		});
 		if (isGoBack(frontendTypes)) return GO_BACK_SYMBOL;
-		if (isCancel$1(frontendTypes)) return exitCancelled("Operation cancelled");
+		if (isCancel$1(frontendTypes)) throw new UserCancelledError({ message: "Operation cancelled" });
 		setIsFirstPrompt(false);
 		const result = [];
 		let shouldRestart = false;
@@ -1076,7 +1147,7 @@ async function getFrontendChoice(frontendOptions, backend, auth) {
 				initialValue: DEFAULT_CONFIG.frontend[0]
 			});
 			if (isGoBack(webFramework)) shouldRestart = true;
-			else if (isCancel$1(webFramework)) return exitCancelled("Operation cancelled");
+			else if (isCancel$1(webFramework)) throw new UserCancelledError({ message: "Operation cancelled" });
 			else result.push(webFramework);
 		}
 		if (shouldRestart) {
@@ -1110,7 +1181,7 @@ async function getFrontendChoice(frontendOptions, backend, auth) {
 				setIsFirstPrompt(wasFirstPrompt);
 				continue;
 			}
-			else if (isCancel$1(nativeFramework)) return exitCancelled("Operation cancelled");
+			else if (isCancel$1(nativeFramework)) throw new UserCancelledError({ message: "Operation cancelled" });
 			else result.push(nativeFramework);
 		}
 		if (shouldRestart) {
@@ -1129,7 +1200,7 @@ async function getGitChoice(git) {
 		message: "Initialize git repository?",
 		initialValue: DEFAULT_CONFIG.git
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -1141,7 +1212,7 @@ async function getinstallChoice(install) {
 		message: "Install dependencies?",
 		initialValue: DEFAULT_CONFIG.install
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -1230,7 +1301,7 @@ async function getORMChoice(orm, hasDatabase, database, backend, runtime) {
 		options: database === "mongodb" ? [ormOptions.prisma, ormOptions.mongoose] : [ormOptions.drizzle, ormOptions.prisma],
 		initialValue: database === "mongodb" ? "prisma" : runtime === "workers" ? "drizzle" : DEFAULT_CONFIG.orm
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -1259,7 +1330,7 @@ async function getPackageManagerChoice(packageManager) {
 		],
 		initialValue: getUserPkgManager()
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -1282,7 +1353,7 @@ async function getPaymentsChoice(payments, auth, backend, frontends) {
 		}],
 		initialValue: DEFAULT_CONFIG.payments
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -1310,7 +1381,7 @@ async function getRuntimeChoice(runtime, backend) {
 		options: runtimeOptions,
 		initialValue: DEFAULT_CONFIG.runtime
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -1354,7 +1425,7 @@ async function getDeploymentChoice(deployment, _runtime, _backend, frontend = []
 		}),
 		initialValue: DEFAULT_CONFIG.webDeploy
 	});
-	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	if (isCancel$1(response)) throw new UserCancelledError({ message: "Operation cancelled" });
 	return response;
 }
 
@@ -1378,7 +1449,9 @@ async function gatherConfig(flags, projectName, projectDir, relativePath) {
 		git: () => getGitChoice(flags.git),
 		packageManager: () => getPackageManagerChoice(flags.packageManager),
 		install: () => getinstallChoice(flags.install)
-	}, { onCancel: () => exitCancelled("Operation cancelled") });
+	}, { onCancel: () => {
+		throw new UserCancelledError({ message: "Operation cancelled" });
+	} });
 	return {
 		projectName,
 		projectDir,
@@ -1445,7 +1518,7 @@ async function getProjectName(initialName) {
 				}
 			}
 		});
-		if (isCancel(response)) return exitCancelled("Operation cancelled.");
+		if (isCancel(response)) throw new UserCancelledError({ message: "Operation cancelled." });
 		projectPath = response || defaultName;
 		isValid = true;
 	}
@@ -1479,25 +1552,27 @@ function isTelemetryEnabled() {
 //#region src/utils/analytics.ts
 const CONVEX_INGEST_URL = "https://striped-seahorse-863.convex.site/api/analytics/ingest";
 async function sendConvexEvent(payload) {
-	try {
-		await fetch(CONVEX_INGEST_URL, {
+	await Result.tryPromise({
+		try: () => fetch(CONVEX_INGEST_URL, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(payload)
-		});
-	} catch {}
+		}),
+		catch: () => void 0
+	});
 }
 async function trackProjectCreation(config, disableAnalytics = false) {
 	if (!isTelemetryEnabled() || disableAnalytics) return;
 	const { projectName: _projectName, projectDir: _projectDir, relativePath: _relativePath, ...safeConfig } = config;
-	try {
-		await sendConvexEvent({
+	await Result.tryPromise({
+		try: () => sendConvexEvent({
 			...safeConfig,
 			cli_version: getLatestCLIVersion(),
 			node_version: typeof process !== "undefined" ? process.version : "",
 			platform: typeof process !== "undefined" ? process.platform : ""
-		});
-	} catch {}
+		}),
+		catch: () => void 0
+	});
 }
 
 //#endregion
@@ -1584,7 +1659,7 @@ async function handleDirectoryConflict(currentPathInput) {
 			finalPathInput: currentPathInput,
 			shouldClearDirectory: false
 		};
-		if (isSilent()) throw new Error(`Directory "${currentPathInput}" already exists and is not empty. In silent mode, please provide a different project name or clear the directory manually.`);
+		if (isSilent()) throw new CLIError({ message: `Directory "${currentPathInput}" already exists and is not empty. In silent mode, please provide a different project name or clear the directory manually.` });
 		log.warn(`Directory "${pc.yellow(currentPathInput)}" already exists and is not empty.`);
 		const action = await select({
 			message: "What would you like to do?",
@@ -1612,7 +1687,7 @@ async function handleDirectoryConflict(currentPathInput) {
 			],
 			initialValue: "rename"
 		});
-		if (isCancel(action)) return exitCancelled("Operation cancelled.");
+		if (isCancel(action)) throw new UserCancelledError({ message: "Operation cancelled." });
 		switch (action) {
 			case "overwrite": return {
 				finalPathInput: currentPathInput,
@@ -1627,7 +1702,7 @@ async function handleDirectoryConflict(currentPathInput) {
 			case "rename":
 				log.info("Please choose a different project name or path.");
 				return await handleDirectoryConflict(await getProjectName(void 0));
-			case "cancel": return exitCancelled("Operation cancelled.");
+			case "cancel": throw new UserCancelledError({ message: "Operation cancelled." });
 		}
 	}
 }
@@ -1644,13 +1719,18 @@ async function setupProjectDirectory(finalPathInput, shouldClearDirectory) {
 	if (shouldClearDirectory) {
 		const s = spinner();
 		s.start(`Clearing directory "${finalResolvedPath}"...`);
-		try {
-			await fs.emptyDir(finalResolvedPath);
-			s.stop(`Directory "${finalResolvedPath}" cleared.`);
-		} catch (error) {
+		const clearResult = await Result.tryPromise({
+			try: () => fs.emptyDir(finalResolvedPath),
+			catch: (error) => new CLIError({
+				message: `Failed to clear directory "${finalResolvedPath}".`,
+				cause: error
+			})
+		});
+		if (clearResult.isErr()) {
 			s.stop(pc.red(`Failed to clear directory "${finalResolvedPath}".`));
-			handleError(error);
+			throw clearResult.error;
 		}
+		s.stop(`Directory "${finalResolvedPath}" cleared.`);
 	} else await fs.ensureDir(finalResolvedPath);
 	return {
 		finalResolvedPath,
@@ -1814,30 +1894,39 @@ function getProvidedFlags(options) {
 	return new Set(Object.keys(options).filter((key) => options[key] !== void 0));
 }
 function validateNoneExclusivity(options, optionName) {
-	if (!options || options.length === 0) return;
-	if (options.includes("none") && options.length > 1) throw new Error(`Cannot combine 'none' with other ${optionName}.`);
+	if (!options || options.length === 0) return Result.ok(void 0);
+	if (options.includes("none") && options.length > 1) return Result.err(new ValidationError({ message: `Cannot combine 'none' with other ${optionName}.` }));
+	return Result.ok(void 0);
 }
 function validateArrayOptions(options) {
-	validateNoneExclusivity(options.frontend, "frontend options");
-	validateNoneExclusivity(options.addons, "addons");
-	validateNoneExclusivity(options.examples, "examples");
+	const frontendResult = validateNoneExclusivity(options.frontend, "frontend options");
+	if (frontendResult.isErr()) return frontendResult;
+	const addonsResult = validateNoneExclusivity(options.addons, "addons");
+	if (addonsResult.isErr()) return addonsResult;
+	const examplesResult = validateNoneExclusivity(options.examples, "examples");
+	if (examplesResult.isErr()) return examplesResult;
+	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") 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("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', 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") 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") exitWithError("Database setup requires a database. Please choose a database or set '--db-setup none'.");
+	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",
@@ -1871,25 +1960,26 @@ function validateDatabaseSetup(config, providedFlags) {
 	if (dbSetup && dbSetup !== "none") {
 		const validation = setupValidations[dbSetup];
 		if (dbSetup === "planetscale") {
-			if (database !== "postgres" && database !== "mysql") exitWithError(validation.errorMessage);
-		} else if (validation.database && database !== validation.database) exitWithError(validation.errorMessage);
-		if (validation.runtime && runtime !== validation.runtime) exitWithError(validation.errorMessage);
+			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") exitWithError("Docker setup is not compatible with SQLite database. SQLite is file-based and doesn't require Docker. Please use '--database postgres', '--database mysql', '--database mongodb', or choose a different setup.");
-			if (runtime === "workers") exitWithError("Docker setup is not compatible with Cloudflare Workers runtime. Workers runtime uses serverless databases (D1) and doesn't support local Docker containers. Please use '--db-setup d1' for SQLite or choose a different runtime.");
+			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;
+	if (backend !== "convex") return Result.ok(void 0);
 	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") 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 supportedFrontends = [
 			"tanstack-router",
@@ -1899,113 +1989,125 @@ 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))) return validationErr("Better-Auth with Convex backend requires a supported frontend (TanStack Router, TanStack Start, Next.js, or Native).");
 	}
+	return Result.ok(void 0);
 }
 function validateBackendNoneConstraints(config, providedFlags) {
 	const { backend } = config;
-	if (backend !== "none") return;
+	if (backend !== "none") return Result.ok(void 0);
 	const has = (k) => providedFlags.has(k);
-	if (has("runtime") && config.runtime !== "none") exitWithError("Backend 'none' requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
-	if (has("database") && config.database !== "none") exitWithError("Backend 'none' requires '--database none'. Please remove the --database flag or set it to 'none'.");
-	if (has("orm") && config.orm !== "none") exitWithError("Backend 'none' requires '--orm none'. Please remove the --orm flag or set it to 'none'.");
-	if (has("api") && config.api !== "none") exitWithError("Backend 'none' requires '--api none'. Please remove the --api flag or set it to 'none'.");
-	if (has("auth") && config.auth !== "none") exitWithError("Backend 'none' requires '--auth none'. Please remove the --auth flag or set it to 'none'.");
-	if (has("payments") && config.payments !== "none") exitWithError("Backend 'none' requires '--payments none'. Please remove the --payments flag or set it to 'none'.");
-	if (has("dbSetup") && config.dbSetup !== "none") exitWithError("Backend 'none' requires '--db-setup none'. Please remove the --db-setup flag or set it to 'none'.");
-	if (has("serverDeploy") && config.serverDeploy !== "none") exitWithError("Backend 'none' requires '--server-deploy none'. Please remove the --server-deploy flag or set it to 'none'.");
+	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;
+	if (backend !== "self") return Result.ok(void 0);
 	const has = (k) => providedFlags.has(k);
-	if (has("runtime") && config.runtime !== "none") exitWithError("Backend 'self' (fullstack) requires '--runtime none'. Please remove the --runtime flag or set it to 'none'.");
+	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" && backend !== "convex") exitWithError("Clerk authentication is only supported with the Convex backend. Please use '--backend convex' or choose a different auth provider.");
+	if (config.auth === "clerk" && backend !== "convex") return validationErr("Clerk authentication is only supported with the Convex backend. Please use '--backend convex' or choose a different auth provider.");
 	if (backend === "convex" && config.auth === "clerk" && config.frontend) {
 		const incompatibleFrontends = config.frontend.filter((f) => [
 			"nuxt",
 			"svelte",
 			"solid"
 		].includes(f));
-		if (incompatibleFrontends.length > 0) exitWithError(`Clerk authentication is not compatible with the following frontends: ${incompatibleFrontends.join(", ")}. Please choose a different frontend or auth provider.`);
+		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") exitWithError("'--runtime none' is only supported with '--backend convex', '--backend none', or '--backend self'. Please choose 'bun', 'node', or remove the --runtime flag.");
+		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) exitWithError(`The following frontends are not compatible with '--backend convex': ${incompatibleFrontends.join(", ")}. Please choose a different frontend or backend.`);
+		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) {
-		ensureSingleWebAndNative(frontend);
-		if (providedFlags.has("api") && providedFlags.has("frontend") && config.api) validateApiFrontendCompatibility(config.api, frontend);
+		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));
-	validateWebDeployRequiresWebFrontend(config.webDeploy, hasWebFrontendFlag);
+	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") exitWithError("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.");
+		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) {
-	validateDatabaseOrmAuth(config, providedFlags);
-	validateDatabaseSetup(config, providedFlags);
-	validateConvexConstraints(config, providedFlags);
-	validateBackendNoneConstraints(config, providedFlags);
-	validateSelfBackendConstraints(config, providedFlags);
-	validateBackendConstraints(config, providedFlags, options);
-	validateFrontendConstraints(config, providedFlags);
-	validateApiConstraints(config, options);
-	validateServerDeployRequiresBackend(config.serverDeploy, config.backend);
-	validateSelfBackendCompatibility(providedFlags, options, config);
-	validateWorkersCompatibility(providedFlags, options, config);
-	if (config.runtime === "workers" && config.serverDeploy === "none") exitWithError("Cloudflare Workers runtime requires a server deployment. Please choose 'alchemy' for --server-deploy.");
-	if (providedFlags.has("serverDeploy") && config.serverDeploy === "cloudflare" && config.runtime !== "workers") exitWithError(`Server deployment '${config.serverDeploy}' requires '--runtime workers'. Please use '--runtime workers' or choose a different server deployment.`);
-	if (config.addons && config.addons.length > 0) {
-		validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
-		config.addons = [...new Set(config.addons)];
-	}
-	validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
-	validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend ?? []);
+	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 'alchemy' 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) {
-	try {
-		validateDatabaseOrmAuth(config);
-		if (config.frontend && config.frontend.length > 0) ensureSingleWebAndNative(config.frontend);
-		validateApiFrontendCompatibility(config.api, config.frontend);
-		validatePaymentsCompatibility(config.payments, config.auth, config.backend, config.frontend);
-		if (config.addons && config.addons.length > 0) validateAddonsAgainstFrontends(config.addons, config.frontend, config.auth);
-		validateExamplesCompatibility(config.examples ?? [], config.backend, config.database, config.frontend ?? [], config.api);
-	} catch (error) {
-		if (error instanceof Error) throw error;
-		throw new Error(String(error));
-	}
+	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/utils/project-name-validation.ts
 function validateProjectName(name) {
 	const result = types_exports.ProjectNameSchema.safeParse(name);
-	if (!result.success) exitWithError(`Invalid project name: ${result.error.issues[0]?.message || "Invalid project name"}`);
-}
-function validateProjectNameThrow(name) {
-	const result = types_exports.ProjectNameSchema.safeParse(name);
-	if (!result.success) throw new Error(`Invalid project name: ${result.error.issues[0]?.message}`);
+	if (!result.success) return Result.err(new ValidationError({
+		field: "projectName",
+		value: name,
+		message: `Invalid project name: ${result.error.issues[0]?.message || "Invalid project name"}`
+	}));
+	return Result.ok(void 0);
 }
-function extractAndValidateProjectName(projectName, projectDirectory, throwOnError = false) {
+function extractAndValidateProjectName(projectName, projectDirectory) {
 	const derivedName = projectName || (projectDirectory ? path.basename(path.resolve(process.cwd(), projectDirectory)) : "");
-	if (!derivedName) return "";
-	const nameToValidate = projectName ? path.basename(projectName) : derivedName;
-	if (throwOnError) validateProjectNameThrow(nameToValidate);
-	else validateProjectName(nameToValidate);
-	return projectName || derivedName;
+	if (!derivedName) return Result.ok("");
+	const validationResult = validateProjectName(projectName ? path.basename(projectName) : derivedName);
+	if (validationResult.isErr()) return Result.err(validationResult.error);
+	return Result.ok(projectName || derivedName);
 }
 
 //#endregion
@@ -2026,97 +2128,111 @@ const CORE_STACK_FLAGS = new Set([
 	"serverDeploy"
 ]);
 function validateYesFlagCombination(options, providedFlags) {
-	if (!options.yes) return;
-	if (options.template && options.template !== "none") return;
+	if (!options.yes) return Result.ok(void 0);
+	if (options.template && options.template !== "none") return Result.ok(void 0);
 	const coreStackFlagsProvided = Array.from(providedFlags).filter((flag) => CORE_STACK_FLAGS.has(flag));
-	if (coreStackFlagsProvided.length > 0) exitWithError(`Cannot combine --yes with core stack configuration flags: ${coreStackFlagsProvided.map((f) => `--${f}`).join(", ")}. The --yes flag uses default configuration. Remove these flags or use --yes without them.`);
+	if (coreStackFlagsProvided.length > 0) return Result.err(new ValidationError({ message: `Cannot combine --yes with core stack configuration flags: ${coreStackFlagsProvided.map((f) => `--${f}`).join(", ")}. The --yes flag uses default configuration. Remove these flags or use --yes without them.` }));
+	return Result.ok(void 0);
 }
 function processAndValidateFlags(options, providedFlags, projectName) {
 	if (options.yolo) {
 		const cfg = processFlags(options, projectName);
-		const validatedProjectName$1 = extractAndValidateProjectName(projectName, options.projectDirectory, true);
-		if (validatedProjectName$1) cfg.projectName = validatedProjectName$1;
-		return cfg;
-	}
-	validateYesFlagCombination(options, providedFlags);
-	try {
-		validateArrayOptions(options);
-	} catch (error) {
-		exitWithError(error instanceof Error ? error.message : String(error));
+		const validatedProjectNameResult$1 = extractAndValidateProjectName(projectName, options.projectDirectory);
+		if (validatedProjectNameResult$1.isOk() && validatedProjectNameResult$1.value) cfg.projectName = validatedProjectNameResult$1.value;
+		return Result.ok(cfg);
 	}
+	const yesFlagResult = validateYesFlagCombination(options, providedFlags);
+	if (yesFlagResult.isErr()) return Result.err(yesFlagResult.error);
+	const arrayOptionsResult = validateArrayOptions(options);
+	if (arrayOptionsResult.isErr()) return Result.err(arrayOptionsResult.error);
 	const config = processFlags(options, projectName);
-	const validatedProjectName = extractAndValidateProjectName(projectName, options.projectDirectory, false);
-	if (validatedProjectName) config.projectName = validatedProjectName;
-	validateFullConfig(config, providedFlags, options);
-	return config;
+	const validatedProjectNameResult = extractAndValidateProjectName(projectName, options.projectDirectory);
+	if (validatedProjectNameResult.isErr()) return Result.err(validatedProjectNameResult.error);
+	if (validatedProjectNameResult.value) config.projectName = validatedProjectNameResult.value;
+	const fullConfigResult = validateFullConfig(config, providedFlags, options);
+	if (fullConfigResult.isErr()) return Result.err(fullConfigResult.error);
+	return Result.ok(config);
 }
 function processProvidedFlagsWithoutValidation(options, projectName) {
-	if (!options.yolo) validateYesFlagCombination(options, getProvidedFlags(options));
+	if (!options.yolo) {
+		const yesFlagResult = validateYesFlagCombination(options, getProvidedFlags(options));
+		if (yesFlagResult.isErr()) return Result.err(yesFlagResult.error);
+	}
 	const config = processFlags(options, projectName);
-	const validatedProjectName = extractAndValidateProjectName(projectName, options.projectDirectory, true);
-	if (validatedProjectName) config.projectName = validatedProjectName;
-	return config;
+	const validatedProjectNameResult = extractAndValidateProjectName(projectName, options.projectDirectory);
+	if (validatedProjectNameResult.isErr()) return Result.err(validatedProjectNameResult.error);
+	if (validatedProjectNameResult.value) config.projectName = validatedProjectNameResult.value;
+	return Result.ok(config);
 }
 function validateConfigCompatibility(config, providedFlags, options) {
-	if (options?.yolo) return;
-	if (options && providedFlags) validateFullConfig(config, providedFlags, options);
-	else validateConfigForProgrammaticUse(config);
+	if (options?.yolo) return Result.ok(void 0);
+	if (options && providedFlags) return validateFullConfig(config, providedFlags, options);
+	else return validateConfigForProgrammaticUse(config);
 }
 
 //#endregion
 //#region src/utils/bts-config.ts
 const BTS_CONFIG_FILE = "bts.jsonc";
 async function writeBtsConfig(projectConfig) {
-	const btsConfig = {
-		version: getLatestCLIVersion(),
-		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-		database: projectConfig.database,
-		orm: projectConfig.orm,
-		backend: projectConfig.backend,
-		runtime: projectConfig.runtime,
-		frontend: projectConfig.frontend,
-		addons: projectConfig.addons,
-		examples: projectConfig.examples,
-		auth: projectConfig.auth,
-		payments: projectConfig.payments,
-		packageManager: projectConfig.packageManager,
-		dbSetup: projectConfig.dbSetup,
-		api: projectConfig.api,
-		webDeploy: projectConfig.webDeploy,
-		serverDeploy: projectConfig.serverDeploy
-	};
-	const baseContent = {
-		$schema: "https://r2.better-t-stack.dev/schema.json",
-		version: btsConfig.version,
-		createdAt: btsConfig.createdAt,
-		database: btsConfig.database,
-		orm: btsConfig.orm,
-		backend: btsConfig.backend,
-		runtime: btsConfig.runtime,
-		frontend: btsConfig.frontend,
-		addons: btsConfig.addons,
-		examples: btsConfig.examples,
-		auth: btsConfig.auth,
-		payments: btsConfig.payments,
-		packageManager: btsConfig.packageManager,
-		dbSetup: btsConfig.dbSetup,
-		api: btsConfig.api,
-		webDeploy: btsConfig.webDeploy,
-		serverDeploy: btsConfig.serverDeploy
-	};
-	let configContent = JSON.stringify(baseContent);
-	const formatResult = JSONC.format(configContent, void 0, {
-		tabSize: 2,
-		insertSpaces: true,
-		eol: "\n"
-	});
-	configContent = JSONC.applyEdits(configContent, formatResult);
-	const finalContent = `// Better-T-Stack configuration file
+	return Result.tryPromise({
+		try: async () => {
+			const btsConfig = {
+				version: getLatestCLIVersion(),
+				createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+				database: projectConfig.database,
+				orm: projectConfig.orm,
+				backend: projectConfig.backend,
+				runtime: projectConfig.runtime,
+				frontend: projectConfig.frontend,
+				addons: projectConfig.addons,
+				examples: projectConfig.examples,
+				auth: projectConfig.auth,
+				payments: projectConfig.payments,
+				packageManager: projectConfig.packageManager,
+				dbSetup: projectConfig.dbSetup,
+				api: projectConfig.api,
+				webDeploy: projectConfig.webDeploy,
+				serverDeploy: projectConfig.serverDeploy
+			};
+			const baseContent = {
+				$schema: "https://r2.better-t-stack.dev/schema.json",
+				version: btsConfig.version,
+				createdAt: btsConfig.createdAt,
+				database: btsConfig.database,
+				orm: btsConfig.orm,
+				backend: btsConfig.backend,
+				runtime: btsConfig.runtime,
+				frontend: btsConfig.frontend,
+				addons: btsConfig.addons,
+				examples: btsConfig.examples,
+				auth: btsConfig.auth,
+				payments: btsConfig.payments,
+				packageManager: btsConfig.packageManager,
+				dbSetup: btsConfig.dbSetup,
+				api: btsConfig.api,
+				webDeploy: btsConfig.webDeploy,
+				serverDeploy: btsConfig.serverDeploy
+			};
+			let configContent = JSON.stringify(baseContent);
+			const formatResult = JSONC.format(configContent, void 0, {
+				tabSize: 2,
+				insertSpaces: true,
+				eol: "\n"
+			});
+			configContent = JSONC.applyEdits(configContent, formatResult);
+			const finalContent = `// Better-T-Stack configuration file
 // safe to delete
 
 ${configContent}`;
-	const configPath = path.join(projectConfig.projectDir, BTS_CONFIG_FILE);
-	await fs.writeFile(configPath, finalContent, "utf-8");
+			const configPath = path.join(projectConfig.projectDir, BTS_CONFIG_FILE);
+			await fs.writeFile(configPath, finalContent, "utf-8");
+		},
+		catch: (e) => new ProjectCreationError({
+			phase: "config-writing",
+			message: `Failed to write BTS config: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 
 //#endregion
@@ -2126,28 +2242,42 @@ const formatOptions = {
 	experimentalSortImports: { order: "asc" }
 };
 async function formatCode(filePath, content) {
-	try {
-		const result = await format(path.basename(filePath), content, formatOptions);
-		if (result.errors && result.errors.length > 0) return null;
-		return result.code;
-	} catch {
-		return null;
-	}
+	const result = await Result.tryPromise({
+		try: async () => {
+			const formatResult = await format(path.basename(filePath), content, formatOptions);
+			if (formatResult.errors && formatResult.errors.length > 0) return null;
+			return formatResult.code;
+		},
+		catch: () => null
+	});
+	return result.isOk() ? result.value : null;
 }
 async function formatProject(projectDir) {
-	async function formatDirectory(dir) {
-		const entries = await fs.readdir(dir, { withFileTypes: true });
-		await Promise.all(entries.map(async (entry) => {
-			const fullPath = path.join(dir, entry.name);
-			if (entry.isDirectory()) await formatDirectory(fullPath);
-			else if (entry.isFile()) try {
-				const content = await fs.readFile(fullPath, "utf-8");
-				const formatted = await formatCode(fullPath, content);
-				if (formatted && formatted !== content) await fs.writeFile(fullPath, formatted, "utf-8");
-			} catch {}
-		}));
-	}
-	await formatDirectory(projectDir);
+	return Result.tryPromise({
+		try: async () => {
+			async function formatDirectory(dir) {
+				const entries = await fs.readdir(dir, { withFileTypes: true });
+				await Promise.all(entries.map(async (entry) => {
+					const fullPath = path.join(dir, entry.name);
+					if (entry.isDirectory()) await formatDirectory(fullPath);
+					else if (entry.isFile()) await Result.tryPromise({
+						try: async () => {
+							const content = await fs.readFile(fullPath, "utf-8");
+							const formatted = await formatCode(fullPath, content);
+							if (formatted && formatted !== content) await fs.writeFile(fullPath, formatted, "utf-8");
+						},
+						catch: () => void 0
+					});
+				}));
+			}
+			await formatDirectory(projectDir);
+		},
+		catch: (e) => new ProjectCreationError({
+			phase: "formatting",
+			message: `Failed to format project: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 
 //#endregion
@@ -2261,40 +2391,49 @@ const TEMPLATES$2 = {
 };
 async function setupFumadocs(config) {
 	const { packageManager, projectDir } = config;
-	try {
-		log.info("Setting up Fumadocs...");
-		const template = await select({
-			message: "Choose a template",
-			options: Object.entries(TEMPLATES$2).map(([key, template$1]) => ({
-				value: key,
-				label: template$1.label,
-				hint: template$1.hint
-			})),
-			initialValue: "next-mdx"
-		});
-		if (isCancel(template)) return exitCancelled("Operation cancelled");
-		const args = getPackageExecutionArgs(packageManager, `create-fumadocs-app@latest fumadocs --template ${TEMPLATES$2[template].value} --src --pm ${packageManager} --no-git`);
-		const appsDir = path.join(projectDir, "apps");
-		await fs.ensureDir(appsDir);
-		const s = spinner();
-		s.start("Running Fumadocs create command...");
-		await $({
-			cwd: appsDir,
-			env: { CI: "true" }
-		})`${args}`;
-		const fumadocsDir = path.join(projectDir, "apps", "fumadocs");
-		const packageJsonPath = path.join(fumadocsDir, "package.json");
-		if (await fs.pathExists(packageJsonPath)) {
-			const packageJson = await fs.readJson(packageJsonPath);
-			packageJson.name = "fumadocs";
-			if (packageJson.scripts?.dev) packageJson.scripts.dev = `${packageJson.scripts.dev} --port=4000`;
-			await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
-		}
-		s.stop("Fumadocs setup complete!");
-	} catch (error) {
-		log.error(pc.red("Failed to set up Fumadocs"));
-		if (error instanceof Error) consola.error(pc.red(error.message));
+	log.info("Setting up Fumadocs...");
+	const template = await select({
+		message: "Choose a template",
+		options: Object.entries(TEMPLATES$2).map(([key, template$1]) => ({
+			value: key,
+			label: template$1.label,
+			hint: template$1.hint
+		})),
+		initialValue: "next-mdx"
+	});
+	if (isCancel(template)) return userCancelled("Operation cancelled");
+	const args = getPackageExecutionArgs(packageManager, `create-fumadocs-app@latest fumadocs --template ${TEMPLATES$2[template].value} --src --pm ${packageManager} --no-git`);
+	const appsDir = path.join(projectDir, "apps");
+	await fs.ensureDir(appsDir);
+	const s = spinner();
+	s.start("Running Fumadocs create command...");
+	const result = await Result.tryPromise({
+		try: async () => {
+			await $({
+				cwd: appsDir,
+				env: { CI: "true" }
+			})`${args}`;
+			const fumadocsDir = path.join(projectDir, "apps", "fumadocs");
+			const packageJsonPath = path.join(fumadocsDir, "package.json");
+			if (await fs.pathExists(packageJsonPath)) {
+				const packageJson = await fs.readJson(packageJsonPath);
+				packageJson.name = "fumadocs";
+				if (packageJson.scripts?.dev) packageJson.scripts.dev = `${packageJson.scripts.dev} --port=4000`;
+				await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+			}
+		},
+		catch: (e) => new AddonSetupError({
+			addon: "fumadocs",
+			message: `Failed to set up Fumadocs: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (result.isErr()) {
+		s.stop("Failed to set up Fumadocs");
+		return result;
 	}
+	s.stop("Fumadocs setup complete!");
+	return Result.ok(void 0);
 }
 
 //#endregion
@@ -2332,79 +2471,84 @@ async function setupOxlint(projectDir, packageManager) {
 //#region src/helpers/addons/ruler-setup.ts
 async function setupRuler(config) {
 	const { packageManager, projectDir } = config;
-	try {
-		log.info("Setting up Ruler...");
-		const rulerDir = path.join(projectDir, ".ruler");
-		if (!await fs.pathExists(rulerDir)) {
-			log.error(pc.red("Ruler template directory not found. Please ensure ruler addon is properly installed."));
-			return;
-		}
-		const selectedEditors = await autocompleteMultiselect({
-			message: "Select AI assistants for Ruler",
-			options: Object.entries({
-				agentsmd: { label: "Agents.md" },
-				aider: { label: "Aider" },
-				amazonqcli: { label: "Amazon Q CLI" },
-				amp: { label: "AMP" },
-				antigravity: { label: "Antigravity" },
-				augmentcode: { label: "AugmentCode" },
-				claude: { label: "Claude Code" },
-				cline: { label: "Cline" },
-				codex: { label: "OpenAI Codex CLI" },
-				copilot: { label: "GitHub Copilot" },
-				crush: { label: "Crush" },
-				cursor: { label: "Cursor" },
-				firebase: { label: "Firebase Studio" },
-				firebender: { label: "Firebender" },
-				"gemini-cli": { label: "Gemini CLI" },
-				goose: { label: "Goose" },
-				jules: { label: "Jules" },
-				junie: { label: "Junie" },
-				kilocode: { label: "Kilo Code" },
-				kiro: { label: "Kiro" },
-				mistral: { label: "Mistral" },
-				opencode: { label: "OpenCode" },
-				openhands: { label: "Open Hands" },
-				qwen: { label: "Qwen" },
-				roo: { label: "RooCode" },
-				trae: { label: "Trae AI" },
-				warp: { label: "Warp" },
-				windsurf: { label: "Windsurf" },
-				zed: { label: "Zed" }
-			}).map(([key, v]) => ({
-				value: key,
-				label: v.label
-			})),
-			required: false
-		});
-		if (isCancel(selectedEditors)) return exitCancelled("Operation cancelled");
-		if (selectedEditors.length === 0) {
-			log.info("No AI assistants selected. To apply rules later, run:");
-			log.info(pc.cyan(`${getPackageExecutionCommand(packageManager, "@intellectronica/ruler@latest apply --local-only")}`));
-			return;
-		}
-		const configFile = path.join(rulerDir, "ruler.toml");
-		let updatedConfig = await fs.readFile(configFile, "utf-8");
-		const defaultAgentsLine = `default_agents = [${selectedEditors.map((editor) => `"${editor}"`).join(", ")}]`;
-		updatedConfig = updatedConfig.replace(/default_agents = \[\]/, defaultAgentsLine);
-		await fs.writeFile(configFile, updatedConfig);
-		await addRulerScriptToPackageJson(projectDir, packageManager);
-		const s = spinner();
-		s.start("Applying rules with Ruler...");
-		try {
+	log.info("Setting up Ruler...");
+	const rulerDir = path.join(projectDir, ".ruler");
+	if (!await fs.pathExists(rulerDir)) {
+		log.error(pc.red("Ruler template directory not found. Please ensure ruler addon is properly installed."));
+		return Result.ok(void 0);
+	}
+	const selectedEditors = await autocompleteMultiselect({
+		message: "Select AI assistants for Ruler",
+		options: Object.entries({
+			agentsmd: { label: "Agents.md" },
+			aider: { label: "Aider" },
+			amazonqcli: { label: "Amazon Q CLI" },
+			amp: { label: "AMP" },
+			antigravity: { label: "Antigravity" },
+			augmentcode: { label: "AugmentCode" },
+			claude: { label: "Claude Code" },
+			cline: { label: "Cline" },
+			codex: { label: "OpenAI Codex CLI" },
+			copilot: { label: "GitHub Copilot" },
+			crush: { label: "Crush" },
+			cursor: { label: "Cursor" },
+			firebase: { label: "Firebase Studio" },
+			firebender: { label: "Firebender" },
+			"gemini-cli": { label: "Gemini CLI" },
+			goose: { label: "Goose" },
+			jules: { label: "Jules" },
+			junie: { label: "Junie" },
+			kilocode: { label: "Kilo Code" },
+			kiro: { label: "Kiro" },
+			mistral: { label: "Mistral" },
+			opencode: { label: "OpenCode" },
+			openhands: { label: "Open Hands" },
+			qwen: { label: "Qwen" },
+			roo: { label: "RooCode" },
+			trae: { label: "Trae AI" },
+			warp: { label: "Warp" },
+			windsurf: { label: "Windsurf" },
+			zed: { label: "Zed" }
+		}).map(([key, v]) => ({
+			value: key,
+			label: v.label
+		})),
+		required: false
+	});
+	if (isCancel(selectedEditors)) return userCancelled("Operation cancelled");
+	if (selectedEditors.length === 0) {
+		log.info("No AI assistants selected. To apply rules later, run:");
+		log.info(pc.cyan(`${getPackageExecutionCommand(packageManager, "@intellectronica/ruler@latest apply --local-only")}`));
+		return Result.ok(void 0);
+	}
+	const configFile = path.join(rulerDir, "ruler.toml");
+	let updatedConfig = await fs.readFile(configFile, "utf-8");
+	const defaultAgentsLine = `default_agents = [${selectedEditors.map((editor) => `"${editor}"`).join(", ")}]`;
+	updatedConfig = updatedConfig.replace(/default_agents = \[\]/, defaultAgentsLine);
+	await fs.writeFile(configFile, updatedConfig);
+	await addRulerScriptToPackageJson(projectDir, packageManager);
+	const s = spinner();
+	s.start("Applying rules with Ruler...");
+	const applyResult = await Result.tryPromise({
+		try: async () => {
 			const rulerApplyArgs = getPackageExecutionArgs(packageManager, `@intellectronica/ruler@latest apply --agents ${selectedEditors.join(",")} --local-only`);
 			await $({
 				cwd: projectDir,
 				env: { CI: "true" }
 			})`${rulerApplyArgs}`;
-			s.stop("Applied rules with Ruler");
-		} catch {
-			s.stop(pc.red("Failed to apply rules"));
-		}
-	} catch (error) {
-		log.error(pc.red("Failed to set up Ruler"));
-		if (error instanceof Error) console.error(pc.red(error.message));
+		},
+		catch: (e) => new AddonSetupError({
+			addon: "ruler",
+			message: `Failed to apply rules: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (applyResult.isErr()) {
+		s.stop(pc.red("Failed to apply rules"));
+		return applyResult;
 	}
+	s.stop("Applied rules with Ruler");
+	return Result.ok(void 0);
 }
 async function addRulerScriptToPackageJson(projectDir, packageManager) {
 	const rootPackageJsonPath = path.join(projectDir, "package.json");
@@ -2424,29 +2568,38 @@ async function addRulerScriptToPackageJson(projectDir, packageManager) {
 async function setupStarlight(config) {
 	const { packageManager, projectDir } = config;
 	const s = spinner();
-	try {
-		s.start("Setting up Starlight docs...");
-		const args = getPackageExecutionArgs(packageManager, `create-astro@latest ${[
-			"docs",
-			"--template",
-			"starlight",
-			"--no-install",
-			"--add",
-			"tailwind",
-			"--no-git",
-			"--skip-houston"
-		].join(" ")}`);
-		const appsDir = path.join(projectDir, "apps");
-		await fs.ensureDir(appsDir);
-		await $({
-			cwd: appsDir,
-			env: { CI: "true" }
-		})`${args}`;
-		s.stop("Starlight docs setup successfully!");
-	} catch (error) {
-		s.stop(pc.red("Failed to set up Starlight docs"));
-		if (error instanceof Error) consola.error(pc.red(error.message));
+	s.start("Setting up Starlight docs...");
+	const args = getPackageExecutionArgs(packageManager, `create-astro@latest ${[
+		"docs",
+		"--template",
+		"starlight",
+		"--no-install",
+		"--add",
+		"tailwind",
+		"--no-git",
+		"--skip-houston"
+	].join(" ")}`);
+	const appsDir = path.join(projectDir, "apps");
+	await fs.ensureDir(appsDir);
+	const result = await Result.tryPromise({
+		try: async () => {
+			await $({
+				cwd: appsDir,
+				env: { CI: "true" }
+			})`${args}`;
+		},
+		catch: (e) => new AddonSetupError({
+			addon: "starlight",
+			message: `Failed to set up Starlight docs: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (result.isErr()) {
+		s.stop("Failed to set up Starlight docs");
+		return result;
 	}
+	s.stop("Starlight docs setup successfully!");
+	return Result.ok(void 0);
 }
 
 //#endregion
@@ -2455,35 +2608,44 @@ async function setupTauri(config) {
 	const { packageManager, frontend, projectDir } = config;
 	const s = spinner();
 	const clientPackageDir = path.join(projectDir, "apps/web");
-	if (!await fs.pathExists(clientPackageDir)) return;
-	try {
-		s.start("Setting up Tauri desktop app support...");
-		const hasReactRouter = frontend.includes("react-router");
-		const hasNuxt = frontend.includes("nuxt");
-		const hasSvelte = frontend.includes("svelte");
-		const hasNext = frontend.includes("next");
-		const devUrl = hasReactRouter || hasSvelte ? "http://localhost:5173" : hasNext ? "http://localhost:3001" : "http://localhost:3001";
-		const frontendDist = hasNuxt ? "../.output/public" : hasSvelte ? "../build" : hasNext ? "../.next" : hasReactRouter ? "../build/client" : "../dist";
-		const tauriArgs = [
-			"@tauri-apps/cli@latest",
-			"init",
-			`--app-name=${path.basename(projectDir)}`,
-			`--window-title=${path.basename(projectDir)}`,
-			`--frontend-dist=${frontendDist}`,
-			`--dev-url=${devUrl}`,
-			`--before-dev-command=${packageManager} run dev`,
-			`--before-build-command=${packageManager} run build`
-		];
-		const prefix = getPackageRunnerPrefix(packageManager);
-		await $({
-			cwd: clientPackageDir,
-			env: { CI: "true" }
-		})`${[...prefix, ...tauriArgs]}`;
-		s.stop("Tauri desktop app support configured successfully!");
-	} catch (error) {
-		s.stop(pc.red("Failed to set up Tauri"));
-		if (error instanceof Error) consola$1.error(pc.red(error.message));
+	if (!await fs.pathExists(clientPackageDir)) return Result.ok(void 0);
+	s.start("Setting up Tauri desktop app support...");
+	const hasReactRouter = frontend.includes("react-router");
+	const hasNuxt = frontend.includes("nuxt");
+	const hasSvelte = frontend.includes("svelte");
+	const hasNext = frontend.includes("next");
+	const devUrl = hasReactRouter || hasSvelte ? "http://localhost:5173" : hasNext ? "http://localhost:3001" : "http://localhost:3001";
+	const frontendDist = hasNuxt ? "../.output/public" : hasSvelte ? "../build" : hasNext ? "../.next" : hasReactRouter ? "../build/client" : "../dist";
+	const tauriArgs = [
+		"@tauri-apps/cli@latest",
+		"init",
+		`--app-name=${path.basename(projectDir)}`,
+		`--window-title=${path.basename(projectDir)}`,
+		`--frontend-dist=${frontendDist}`,
+		`--dev-url=${devUrl}`,
+		`--before-dev-command=${packageManager} run dev`,
+		`--before-build-command=${packageManager} run build`
+	];
+	const prefix = getPackageRunnerPrefix(packageManager);
+	const result = await Result.tryPromise({
+		try: async () => {
+			await $({
+				cwd: clientPackageDir,
+				env: { CI: "true" }
+			})`${[...prefix, ...tauriArgs]}`;
+		},
+		catch: (e) => new AddonSetupError({
+			addon: "tauri",
+			message: `Failed to set up Tauri: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (result.isErr()) {
+		s.stop("Failed to set up Tauri");
+		return result;
 	}
+	s.stop("Tauri desktop app support configured successfully!");
+	return Result.ok(void 0);
 }
 
 //#endregion
@@ -2504,32 +2666,52 @@ const TEMPLATES$1 = {
 };
 async function setupTui(config) {
 	const { packageManager, projectDir } = config;
-	try {
-		log.info("Setting up OpenTUI...");
-		const template = await select({
-			message: "Choose a template",
-			options: Object.entries(TEMPLATES$1).map(([key, template$1]) => ({
-				value: key,
-				label: template$1.label,
-				hint: template$1.hint
-			})),
-			initialValue: "core"
-		});
-		if (isCancel(template)) return exitCancelled("Operation cancelled");
-		const args = getPackageExecutionArgs(packageManager, `create-tui@latest --template ${template} --no-git --no-install tui`);
-		const appsDir = path.join(projectDir, "apps");
-		await fs.ensureDir(appsDir);
-		const s = spinner();
-		s.start("Running OpenTUI create command...");
-		await $({
-			cwd: appsDir,
-			env: { CI: "true" }
-		})`${args}`;
-		s.stop("OpenTUI setup complete!");
-	} catch (error) {
+	log.info("Setting up OpenTUI...");
+	const template = await select({
+		message: "Choose a template",
+		options: Object.entries(TEMPLATES$1).map(([key, template$1]) => ({
+			value: key,
+			label: template$1.label,
+			hint: template$1.hint
+		})),
+		initialValue: "core"
+	});
+	if (isCancel(template)) return userCancelled("Operation cancelled");
+	const args = getPackageExecutionArgs(packageManager, `create-tui@latest --template ${template} --no-git --no-install tui`);
+	const appsDir = path.join(projectDir, "apps");
+	const ensureDirResult = await Result.tryPromise({
+		try: () => fs.ensureDir(appsDir),
+		catch: (e) => new AddonSetupError({
+			addon: "tui",
+			message: `Failed to create directory: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (ensureDirResult.isErr()) return ensureDirResult;
+	const s = spinner();
+	s.start("Running OpenTUI create command...");
+	const initResult = await Result.tryPromise({
+		try: async () => {
+			await $({
+				cwd: appsDir,
+				env: { CI: "true" }
+			})`${args}`;
+		},
+		catch: (e) => {
+			s.stop(pc.red("Failed to run OpenTUI create command"));
+			return new AddonSetupError({
+				addon: "tui",
+				message: `Failed to set up OpenTUI: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
+		}
+	});
+	if (initResult.isErr()) {
 		log.error(pc.red("Failed to set up OpenTUI"));
-		if (error instanceof Error) console.error(pc.red(error.message));
+		return initResult;
 	}
+	s.stop("OpenTUI setup complete!");
+	return Result.ok(void 0);
 }
 
 //#endregion
@@ -2609,77 +2791,108 @@ function getFrameworksFromFrontend(frontend) {
 }
 async function setupUltracite(config, gitHooks) {
 	const { packageManager, projectDir, frontend } = config;
-	try {
-		log.info("Setting up Ultracite...");
-		const result = await group({
-			linter: () => select({
-				message: "Choose linter/formatter",
-				options: Object.entries(LINTERS).map(([key, linter$1]) => ({
-					value: key,
-					label: linter$1.label,
-					hint: linter$1.hint
-				})),
-				initialValue: "biome"
-			}),
-			editors: () => multiselect({
-				message: "Choose editors",
-				options: Object.entries(EDITORS).map(([key, editor]) => ({
-					value: key,
-					label: editor.label
-				})),
-				required: true
-			}),
-			agents: () => multiselect({
-				message: "Choose agents",
-				options: Object.entries(AGENTS).map(([key, agent]) => ({
-					value: key,
-					label: agent.label
-				})),
-				required: true
-			}),
-			hooks: () => multiselect({
-				message: "Choose hooks",
-				options: Object.entries(HOOKS).map(([key, hook]) => ({
-					value: key,
-					label: hook.label
-				}))
-			})
-		}, { onCancel: () => {
-			exitCancelled("Operation cancelled");
-		} });
-		const linter = result.linter;
-		const editors = result.editors;
-		const agents = result.agents;
-		const hooks = result.hooks;
-		const frameworks = getFrameworksFromFrontend(frontend);
-		const ultraciteArgs = [
-			"init",
-			"--pm",
-			packageManager,
-			"--linter",
-			linter
-		];
-		if (frameworks.length > 0) ultraciteArgs.push("--frameworks", ...frameworks);
-		if (editors.length > 0) ultraciteArgs.push("--editors", ...editors);
-		if (agents.length > 0) ultraciteArgs.push("--agents", ...agents);
-		if (hooks.length > 0) ultraciteArgs.push("--hooks", ...hooks);
-		if (gitHooks.length > 0) {
-			const integrations = [...gitHooks];
-			if (gitHooks.includes("husky")) integrations.push("lint-staged");
-			ultraciteArgs.push("--integrations", ...integrations);
+	log.info("Setting up Ultracite...");
+	let result;
+	const groupResult = await Result.tryPromise({
+		try: async () => {
+			return await group({
+				linter: () => select({
+					message: "Choose linter/formatter",
+					options: Object.entries(LINTERS).map(([key, linter$1]) => ({
+						value: key,
+						label: linter$1.label,
+						hint: linter$1.hint
+					})),
+					initialValue: "biome"
+				}),
+				editors: () => multiselect({
+					message: "Choose editors",
+					options: Object.entries(EDITORS).map(([key, editor]) => ({
+						value: key,
+						label: editor.label
+					})),
+					required: true
+				}),
+				agents: () => multiselect({
+					message: "Choose agents",
+					options: Object.entries(AGENTS).map(([key, agent]) => ({
+						value: key,
+						label: agent.label
+					})),
+					required: true
+				}),
+				hooks: () => multiselect({
+					message: "Choose hooks",
+					options: Object.entries(HOOKS).map(([key, hook]) => ({
+						value: key,
+						label: hook.label
+					}))
+				})
+			}, { onCancel: () => {
+				throw new UserCancelledError({ message: "Operation cancelled" });
+			} });
+		},
+		catch: (e) => {
+			if (e instanceof UserCancelledError) return e;
+			return new AddonSetupError({
+				addon: "ultracite",
+				message: `Failed to get user preferences: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
 		}
-		const args = getPackageExecutionArgs(packageManager, `ultracite@latest ${ultraciteArgs.join(" ")} --skip-install`);
-		const s = spinner();
-		s.start("Running Ultracite init command...");
-		await $({
-			cwd: projectDir,
-			env: { CI: "true" }
-		})`${args}`;
-		s.stop("Ultracite setup successfully!");
-	} catch (error) {
+	});
+	if (groupResult.isErr()) {
+		if (UserCancelledError.is(groupResult.error)) return userCancelled(groupResult.error.message);
+		log.error(pc.red("Failed to set up Ultracite"));
+		return groupResult;
+	}
+	result = groupResult.value;
+	const linter = result.linter;
+	const editors = result.editors;
+	const agents = result.agents;
+	const hooks = result.hooks;
+	const frameworks = getFrameworksFromFrontend(frontend);
+	const ultraciteArgs = [
+		"init",
+		"--pm",
+		packageManager,
+		"--linter",
+		linter
+	];
+	if (frameworks.length > 0) ultraciteArgs.push("--frameworks", ...frameworks);
+	if (editors.length > 0) ultraciteArgs.push("--editors", ...editors);
+	if (agents.length > 0) ultraciteArgs.push("--agents", ...agents);
+	if (hooks.length > 0) ultraciteArgs.push("--hooks", ...hooks);
+	if (gitHooks.length > 0) {
+		const integrations = [...gitHooks];
+		if (gitHooks.includes("husky")) integrations.push("lint-staged");
+		ultraciteArgs.push("--integrations", ...integrations);
+	}
+	const args = getPackageExecutionArgs(packageManager, `ultracite@latest ${ultraciteArgs.join(" ")} --skip-install`);
+	const s = spinner();
+	s.start("Running Ultracite init command...");
+	const initResult = await Result.tryPromise({
+		try: async () => {
+			await $({
+				cwd: projectDir,
+				env: { CI: "true" }
+			})`${args}`;
+		},
+		catch: (e) => {
+			s.stop(pc.red("Failed to run Ultracite init command"));
+			return new AddonSetupError({
+				addon: "ultracite",
+				message: `Failed to set up Ultracite: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
+		}
+	});
+	if (initResult.isErr()) {
 		log.error(pc.red("Failed to set up Ultracite"));
-		if (error instanceof Error) console.error(pc.red(error.message));
+		return initResult;
 	}
+	s.stop("Ultracite setup successfully!");
+	return Result.ok(void 0);
 }
 
 //#endregion
@@ -2708,44 +2921,80 @@ const TEMPLATES = {
 };
 async function setupWxt(config) {
 	const { packageManager, projectDir } = config;
-	try {
-		log.info("Setting up WXT...");
-		const template = await select({
-			message: "Choose a template",
-			options: Object.entries(TEMPLATES).map(([key, template$1]) => ({
-				value: key,
-				label: template$1.label,
-				hint: template$1.hint
-			})),
-			initialValue: "react"
-		});
-		if (isCancel(template)) return exitCancelled("Operation cancelled");
-		const args = getPackageExecutionArgs(packageManager, `wxt@latest init extension --template ${template} --pm ${packageManager}`);
-		const appsDir = path.join(projectDir, "apps");
-		await fs.ensureDir(appsDir);
-		const s = spinner();
-		s.start("Running WXT init command...");
-		await $({
-			cwd: appsDir,
-			env: { CI: "true" }
-		})`${args}`;
-		const extensionDir = path.join(projectDir, "apps", "extension");
-		const packageJsonPath = path.join(extensionDir, "package.json");
-		if (await fs.pathExists(packageJsonPath)) {
-			const packageJson = await fs.readJson(packageJsonPath);
-			packageJson.name = "extension";
-			if (packageJson.scripts?.dev) packageJson.scripts.dev = `${packageJson.scripts.dev} --port 5555`;
-			await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
-		}
-		s.stop("WXT setup complete!");
-	} catch (error) {
-		log.error(pc.red("Failed to set up WXT"));
-		if (error instanceof Error) console.error(pc.red(error.message));
-	}
-}
-
+	log.info("Setting up WXT...");
+	const template = await select({
+		message: "Choose a template",
+		options: Object.entries(TEMPLATES).map(([key, template$1]) => ({
+			value: key,
+			label: template$1.label,
+			hint: template$1.hint
+		})),
+		initialValue: "react"
+	});
+	if (isCancel(template)) return userCancelled("Operation cancelled");
+	const args = getPackageExecutionArgs(packageManager, `wxt@latest init extension --template ${template} --pm ${packageManager}`);
+	const appsDir = path.join(projectDir, "apps");
+	const ensureDirResult = await Result.tryPromise({
+		try: () => fs.ensureDir(appsDir),
+		catch: (e) => new AddonSetupError({
+			addon: "wxt",
+			message: `Failed to create directory: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (ensureDirResult.isErr()) return ensureDirResult;
+	const s = spinner();
+	s.start("Running WXT init command...");
+	const initResult = await Result.tryPromise({
+		try: async () => {
+			await $({
+				cwd: appsDir,
+				env: { CI: "true" }
+			})`${args}`;
+		},
+		catch: (e) => {
+			s.stop(pc.red("Failed to run WXT init command"));
+			return new AddonSetupError({
+				addon: "wxt",
+				message: `Failed to set up WXT: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
+		}
+	});
+	if (initResult.isErr()) {
+		log.error(pc.red("Failed to set up WXT"));
+		return initResult;
+	}
+	const extensionDir = path.join(projectDir, "apps", "extension");
+	const packageJsonPath = path.join(extensionDir, "package.json");
+	if ((await Result.tryPromise({
+		try: async () => {
+			if (await fs.pathExists(packageJsonPath)) {
+				const packageJson = await fs.readJson(packageJsonPath);
+				packageJson.name = "extension";
+				if (packageJson.scripts?.dev) packageJson.scripts.dev = `${packageJson.scripts.dev} --port 5555`;
+				await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+			}
+		},
+		catch: (e) => new AddonSetupError({
+			addon: "wxt",
+			message: `Failed to update package.json: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	})).isErr()) log.warn(pc.yellow("WXT setup completed but failed to update package.json"));
+	s.stop("WXT setup complete!");
+	return Result.ok(void 0);
+}
+
 //#endregion
 //#region src/helpers/addons/addons-setup.ts
+async function runSetup(setupFn) {
+	const result = await setupFn();
+	if (result.isErr()) {
+		if (UserCancelledError.is(result.error)) throw result.error;
+		consola.error(pc.red(result.error.message));
+	}
+}
 async function setupAddons(config) {
 	const { addons, frontend, projectDir } = config;
 	const hasReactWebFrontend = frontend.includes("react-router") || frontend.includes("tanstack-router") || frontend.includes("next");
@@ -2753,7 +3002,7 @@ async function setupAddons(config) {
 	const hasSvelteFrontend = frontend.includes("svelte");
 	const hasSolidFrontend = frontend.includes("solid");
 	const hasNextFrontend = frontend.includes("next");
-	if (addons.includes("tauri") && (hasReactWebFrontend || hasNuxtFrontend || hasSvelteFrontend || hasSolidFrontend || hasNextFrontend)) await setupTauri(config);
+	if (addons.includes("tauri") && (hasReactWebFrontend || hasNuxtFrontend || hasSvelteFrontend || hasSolidFrontend || hasNextFrontend)) await runSetup(() => setupTauri(config));
 	const hasUltracite = addons.includes("ultracite");
 	const hasBiome = addons.includes("biome");
 	const hasHusky = addons.includes("husky");
@@ -2763,7 +3012,7 @@ async function setupAddons(config) {
 		const gitHooks = [];
 		if (hasHusky) gitHooks.push("husky");
 		if (hasLefthook) gitHooks.push("lefthook");
-		await setupUltracite(config, gitHooks);
+		await runSetup(() => setupUltracite(config, gitHooks));
 	} else {
 		if (hasBiome) await setupBiome(projectDir);
 		if (hasOxlint) await setupOxlint(projectDir, config.packageManager);
@@ -2775,11 +3024,11 @@ async function setupAddons(config) {
 			if (hasLefthook) await setupLefthook(projectDir);
 		}
 	}
-	if (addons.includes("starlight")) await setupStarlight(config);
-	if (addons.includes("fumadocs")) await setupFumadocs(config);
-	if (addons.includes("opentui")) await setupTui(config);
-	if (addons.includes("wxt")) await setupWxt(config);
-	if (addons.includes("ruler")) await setupRuler(config);
+	if (addons.includes("starlight")) await runSetup(() => setupStarlight(config));
+	if (addons.includes("fumadocs")) await runSetup(() => setupFumadocs(config));
+	if (addons.includes("opentui")) await runSetup(() => setupTui(config));
+	if (addons.includes("wxt")) await runSetup(() => setupWxt(config));
+	if (addons.includes("ruler")) await runSetup(() => setupRuler(config));
 }
 async function setupBiome(projectDir) {
 	await addPackageDependency({
@@ -2873,12 +3122,18 @@ async function setupCloudflareD1(config) {
 //#region src/helpers/database-providers/docker-compose-setup.ts
 async function setupDockerCompose(config) {
 	const { database, projectDir, projectName, backend } = config;
-	if (database === "none" || database === "sqlite") return;
-	try {
-		await writeEnvFile$4(projectDir, database, projectName, backend);
-	} catch (error) {
-		if (error instanceof Error) console.error(`Error: ${error.message}`);
-	}
+	if (database === "none" || database === "sqlite") return Result.ok(void 0);
+	const result = await Result.tryPromise({
+		try: async () => {
+			await writeEnvFile$4(projectDir, database, projectName, backend);
+		},
+		catch: (e) => new DatabaseSetupError({
+			provider: "docker-compose",
+			message: `Failed to setup docker compose env: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	return result.isErr() ? result : Result.ok(void 0);
 }
 async function writeEnvFile$4(projectDir, database, projectName, backend) {
 	const targetApp = backend === "self" ? "apps/web" : "apps/server";
@@ -2900,69 +3155,75 @@ function getDatabaseUrl(database, projectName) {
 //#endregion
 //#region src/utils/command-exists.ts
 async function commandExists(command) {
-	try {
-		if (process.platform === "win32") return (await $({ reject: false })`where ${command}`).exitCode === 0;
-		return (await $({ reject: false })`which ${command}`).exitCode === 0;
-	} catch {
-		return false;
-	}
+	const result = await Result.tryPromise({
+		try: async () => {
+			if (process.platform === "win32") return (await $({ reject: false })`where ${command}`).exitCode === 0;
+			return (await $({ reject: false })`which ${command}`).exitCode === 0;
+		},
+		catch: () => false
+	});
+	return result.isOk() ? result.value : false;
 }
 
 //#endregion
 //#region src/helpers/database-providers/mongodb-atlas-setup.ts
 async function checkAtlasCLI() {
-	try {
-		const exists = await commandExists("atlas");
-		if (exists) log.info("MongoDB Atlas CLI found");
-		else log.warn(pc.yellow("MongoDB Atlas CLI not found"));
-		return exists;
-	} catch {
-		log.error(pc.red("Error checking MongoDB Atlas CLI"));
-		return false;
-	}
+	const exists = await commandExists("atlas");
+	if (exists) log.info("MongoDB Atlas CLI found");
+	else log.warn(pc.yellow("MongoDB Atlas CLI not found"));
+	return exists;
 }
 async function initMongoDBAtlas(serverDir) {
-	try {
-		if (!await checkAtlasCLI()) {
-			consola.error(pc.red("MongoDB Atlas CLI not found."));
-			log.info(pc.yellow("Please install it from: https://www.mongodb.com/docs/atlas/cli/current/install-atlas-cli/"));
-			return null;
-		}
-		log.info("Running MongoDB Atlas setup...");
-		await $({
-			cwd: serverDir,
-			stdio: "inherit"
-		})`atlas deployments setup`;
-		log.success("MongoDB Atlas deployment ready");
-		const connectionString = await text({
-			message: "Enter your MongoDB connection string:",
-			placeholder: "mongodb+srv://username:password@cluster.mongodb.net/database",
-			validate(value) {
-				if (!value) return "Please enter a connection string";
-				if (!value.startsWith("mongodb")) return "URL should start with mongodb:// or mongodb+srv://";
-			}
-		});
-		if (isCancel(connectionString)) {
-			cancel("MongoDB setup cancelled");
-			return null;
+	if (!await checkAtlasCLI()) {
+		log.info(pc.yellow("Please install it from: https://www.mongodb.com/docs/atlas/cli/current/install-atlas-cli/"));
+		return databaseSetupError("mongodb-atlas", "MongoDB Atlas CLI not found");
+	}
+	log.info("Running MongoDB Atlas setup...");
+	const deployResult = await Result.tryPromise({
+		try: async () => {
+			await $({
+				cwd: serverDir,
+				stdio: "inherit"
+			})`atlas deployments setup`;
+			log.success("MongoDB Atlas deployment ready");
+		},
+		catch: (e) => new DatabaseSetupError({
+			provider: "mongodb-atlas",
+			message: `Failed to setup MongoDB Atlas deployment: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (deployResult.isErr()) return deployResult;
+	const connectionString = await text({
+		message: "Enter your MongoDB connection string:",
+		placeholder: "mongodb+srv://username:password@cluster.mongodb.net/database",
+		validate(value) {
+			if (!value) return "Please enter a connection string";
+			if (!value.startsWith("mongodb")) return "URL should start with mongodb:// or mongodb+srv://";
 		}
-		return { connectionString };
-	} catch (error) {
-		if (error instanceof Error) consola.error(pc.red(error.message));
-		return null;
+	});
+	if (isCancel(connectionString)) {
+		cancel("MongoDB setup cancelled");
+		return userCancelled("MongoDB setup cancelled");
 	}
+	return Result.ok({ connectionString });
 }
 async function writeEnvFile$3(projectDir, backend, config) {
-	try {
-		const targetApp = backend === "self" ? "apps/web" : "apps/server";
-		await addEnvVariablesToFile(path.join(projectDir, targetApp, ".env"), [{
-			key: "DATABASE_URL",
-			value: config?.connectionString ?? "mongodb://localhost:27017/mydb",
-			condition: true
-		}]);
-	} catch {
-		consola.error("Failed to update environment configuration");
-	}
+	return Result.tryPromise({
+		try: async () => {
+			const targetApp = backend === "self" ? "apps/web" : "apps/server";
+			await addEnvVariablesToFile(path.join(projectDir, targetApp, ".env"), [{
+				key: "DATABASE_URL",
+				value: config?.connectionString ?? "mongodb://localhost:27017/mydb",
+				condition: true
+			}]);
+		},
+		catch: (e) => new DatabaseSetupError({
+			provider: "mongodb-atlas",
+			message: `Failed to update environment configuration: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 function displayManualSetupInstructions$3() {
 	log.info(`
@@ -2985,50 +3246,56 @@ async function setupMongoDBAtlas(config, cliInput) {
 	const { projectDir, backend } = config;
 	const manualDb = cliInput?.manualDb ?? false;
 	const serverDir = path.join(projectDir, "packages/db");
-	try {
-		await fs.ensureDir(serverDir);
-		if (manualDb) {
-			log.info("MongoDB Atlas manual setup selected");
-			await writeEnvFile$3(projectDir, backend);
-			displayManualSetupInstructions$3();
-			return;
-		}
-		const mode = await select({
-			message: "MongoDB Atlas setup: choose mode",
-			options: [{
-				label: "Automatic",
-				value: "auto",
-				hint: "Automated setup with provider CLI, sets .env"
-			}, {
-				label: "Manual",
-				value: "manual",
-				hint: "Manual setup, add env vars yourself"
-			}],
-			initialValue: "auto"
-		});
-		if (isCancel(mode)) return exitCancelled("Operation cancelled");
-		if (mode === "manual") {
-			log.info("MongoDB Atlas manual setup selected");
-			await writeEnvFile$3(projectDir, backend);
-			displayManualSetupInstructions$3();
-			return;
-		}
-		const config$1 = await initMongoDBAtlas(serverDir);
-		if (config$1) {
-			await writeEnvFile$3(projectDir, backend, config$1);
-			log.success(pc.green("MongoDB Atlas setup complete! Connection saved to .env file."));
-		} else {
-			log.warn(pc.yellow("Falling back to local MongoDB configuration"));
-			await writeEnvFile$3(projectDir, backend);
-			displayManualSetupInstructions$3();
-		}
-	} catch (error) {
-		consola.error(pc.red(`Error during MongoDB Atlas setup: ${error instanceof Error ? error.message : String(error)}`));
-		try {
-			await writeEnvFile$3(projectDir, backend);
-			displayManualSetupInstructions$3();
-		} catch {}
+	const ensureDirResult = await Result.tryPromise({
+		try: () => fs.ensureDir(serverDir),
+		catch: (e) => new DatabaseSetupError({
+			provider: "mongodb-atlas",
+			message: `Failed to create directory: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (ensureDirResult.isErr()) return ensureDirResult;
+	if (manualDb) {
+		log.info("MongoDB Atlas manual setup selected");
+		const envResult$1 = await writeEnvFile$3(projectDir, backend);
+		if (envResult$1.isErr()) return envResult$1;
+		displayManualSetupInstructions$3();
+		return Result.ok(void 0);
 	}
+	const mode = await select({
+		message: "MongoDB Atlas setup: choose mode",
+		options: [{
+			label: "Automatic",
+			value: "auto",
+			hint: "Automated setup with provider CLI, sets .env"
+		}, {
+			label: "Manual",
+			value: "manual",
+			hint: "Manual setup, add env vars yourself"
+		}],
+		initialValue: "auto"
+	});
+	if (isCancel(mode)) return userCancelled("Operation cancelled");
+	if (mode === "manual") {
+		log.info("MongoDB Atlas manual setup selected");
+		const envResult$1 = await writeEnvFile$3(projectDir, backend);
+		if (envResult$1.isErr()) return envResult$1;
+		displayManualSetupInstructions$3();
+		return Result.ok(void 0);
+	}
+	const mongoConfigResult = await initMongoDBAtlas(serverDir);
+	if (mongoConfigResult.isOk()) {
+		const envResult$1 = await writeEnvFile$3(projectDir, backend, mongoConfigResult.value);
+		if (envResult$1.isErr()) return envResult$1;
+		log.success(pc.green("MongoDB Atlas setup complete! Connection saved to .env file."));
+		return Result.ok(void 0);
+	}
+	if (UserCancelledError.is(mongoConfigResult.error)) return mongoConfigResult;
+	log.warn(pc.yellow("Falling back to local MongoDB configuration"));
+	const envResult = await writeEnvFile$3(projectDir, backend);
+	if (envResult.isErr()) return envResult;
+	displayManualSetupInstructions$3();
+	return Result.ok(void 0);
 }
 
 //#endregion
@@ -3069,62 +3336,99 @@ const NEON_REGIONS = [
 ];
 async function executeNeonCommand(packageManager, commandArgsString, spinnerText) {
 	const s = spinner();
-	try {
-		const args = getPackageExecutionArgs(packageManager, commandArgsString);
-		if (spinnerText) s.start(spinnerText);
-		const result = await $`${args}`;
-		if (spinnerText) s.stop(pc.green(spinnerText.replace("...", "").replace("ing ", "ed ").trim()));
-		return result;
-	} catch (error) {
-		if (s) s.stop(pc.red(`Failed: ${spinnerText || "Command execution"}`));
-		throw error;
-	}
+	const args = getPackageExecutionArgs(packageManager, commandArgsString);
+	if (spinnerText) s.start(spinnerText);
+	return Result.tryPromise({
+		try: async () => {
+			const result = await $`${args}`;
+			if (spinnerText) s.stop(pc.green(spinnerText.replace("...", "").replace("ing ", "ed ").trim()));
+			return result;
+		},
+		catch: (e) => {
+			if (s) s.stop(pc.red(`Failed: ${spinnerText || "Command execution"}`));
+			return new DatabaseSetupError({
+				provider: "neon",
+				message: `Command failed: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
+		}
+	});
 }
 async function createNeonProject(projectName, regionId, packageManager) {
-	try {
-		const { stdout } = await executeNeonCommand(packageManager, `neonctl@latest projects create --name ${projectName} --region-id ${regionId} --output json`, `Creating Neon project "${projectName}"...`);
-		const response = JSON.parse(stdout);
-		if (response.project && response.connection_uris && response.connection_uris.length > 0) {
-			const projectId = response.project.id;
-			const connectionUri = response.connection_uris[0].connection_uri;
-			const params = response.connection_uris[0].connection_parameters;
-			return {
-				connectionString: connectionUri,
-				projectId,
-				dbName: params.database,
-				roleName: params.role
-			};
-		}
-		consola$1.error(pc.red("Failed to extract connection information from response"));
-		return null;
-	} catch {
-		consola$1.error(pc.red("Failed to create Neon project"));
+	const execResult = await executeNeonCommand(packageManager, `neonctl@latest projects create --name ${projectName} --region-id ${regionId} --output json`, `Creating Neon project "${projectName}"...`);
+	if (execResult.isErr()) return execResult;
+	const parseResult = Result.try({
+		try: () => JSON.parse(execResult.value.stdout),
+		catch: (e) => new DatabaseSetupError({
+			provider: "neon",
+			message: `Failed to parse Neon response: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (parseResult.isErr()) return parseResult;
+	const response = parseResult.value;
+	if (response.project && response.connection_uris && response.connection_uris.length > 0) {
+		const projectId = response.project.id;
+		const connectionUri = response.connection_uris[0].connection_uri;
+		const params = response.connection_uris[0].connection_parameters;
+		return Result.ok({
+			connectionString: connectionUri,
+			projectId,
+			dbName: params.database,
+			roleName: params.role
+		});
 	}
+	return databaseSetupError("neon", "Failed to extract connection information from Neon response");
 }
 async function writeEnvFile$2(projectDir, backend, config) {
-	const targetApp = backend === "self" ? "apps/web" : "apps/server";
-	await addEnvVariablesToFile(path.join(projectDir, targetApp, ".env"), [{
-		key: "DATABASE_URL",
-		value: config?.connectionString ?? "postgresql://postgres:postgres@localhost:5432/mydb?schema=public",
-		condition: true
-	}]);
-	return true;
+	return Result.tryPromise({
+		try: async () => {
+			const targetApp = backend === "self" ? "apps/web" : "apps/server";
+			await addEnvVariablesToFile(path.join(projectDir, targetApp, ".env"), [{
+				key: "DATABASE_URL",
+				value: config?.connectionString ?? "postgresql://postgres:postgres@localhost:5432/mydb?schema=public",
+				condition: true
+			}]);
+		},
+		catch: (e) => new DatabaseSetupError({
+			provider: "neon",
+			message: `Failed to update .env file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 async function setupWithNeonDb(projectDir, packageManager, backend) {
-	try {
-		const s = spinner();
-		s.start("Creating Neon database using get-db...");
-		const targetApp = backend === "self" ? "apps/web" : "apps/server";
-		const targetDir = path.join(projectDir, targetApp);
-		await fs.ensureDir(targetDir);
-		const packageArgs = getPackageExecutionArgs(packageManager, "get-db@latest --yes");
-		await $({ cwd: targetDir })`${packageArgs}`;
-		s.stop(pc.green("Neon database created successfully!"));
-		return true;
-	} catch (error) {
-		consola$1.error(pc.red("Failed to create database with get-db"));
-		throw error;
+	const s = spinner();
+	s.start("Creating Neon database using get-db...");
+	const targetApp = backend === "self" ? "apps/web" : "apps/server";
+	const targetDir = path.join(projectDir, targetApp);
+	const ensureDirResult = await Result.tryPromise({
+		try: () => fs.ensureDir(targetDir),
+		catch: (e) => new DatabaseSetupError({
+			provider: "neon",
+			message: `Failed to create directory: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (ensureDirResult.isErr()) {
+		s.stop(pc.red("Failed to create directory"));
+		return ensureDirResult;
 	}
+	const packageArgs = getPackageExecutionArgs(packageManager, "get-db@latest --yes");
+	return Result.tryPromise({
+		try: async () => {
+			await $({ cwd: targetDir })`${packageArgs}`;
+			s.stop(pc.green("Neon database created successfully!"));
+		},
+		catch: (e) => {
+			s.stop(pc.red("Failed to create database with get-db"));
+			return new DatabaseSetupError({
+				provider: "neon",
+				message: `Failed to create database with get-db: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
+		}
+	});
 }
 function displayManualSetupInstructions$2(target) {
 	log.info(`Manual Neon PostgreSQL Setup Instructions:
@@ -3139,71 +3443,87 @@ DATABASE_URL="your_connection_string"`);
 async function setupNeonPostgres(config, cliInput) {
 	const { packageManager, projectDir, backend } = config;
 	const manualDb = cliInput?.manualDb ?? false;
-	try {
-		if (manualDb) {
-			await writeEnvFile$2(projectDir, backend);
-			displayManualSetupInstructions$2(backend === "self" ? "apps/web" : "apps/server");
-			return;
-		}
-		const mode = await select({
-			message: "Neon setup: choose mode",
-			options: [{
-				label: "Automatic",
-				value: "auto",
-				hint: "Automated setup with provider CLI, sets .env"
-			}, {
-				label: "Manual",
-				value: "manual",
-				hint: "Manual setup, add env vars yourself"
-			}],
-			initialValue: "auto"
-		});
-		if (isCancel(mode)) return exitCancelled("Operation cancelled");
-		if (mode === "manual") {
-			await writeEnvFile$2(projectDir, backend);
-			displayManualSetupInstructions$2(backend === "self" ? "apps/web" : "apps/server");
-			return;
-		}
-		const setupMethod = await select({
-			message: "Choose your Neon setup method:",
-			options: [{
-				label: "Quick setup with get-db",
-				value: "neondb",
-				hint: "fastest, no auth required"
-			}, {
-				label: "Custom setup with neonctl",
-				value: "neonctl",
-				hint: "More control - choose project name and region"
-			}],
-			initialValue: "neondb"
-		});
-		if (isCancel(setupMethod)) return exitCancelled("Operation cancelled");
-		if (setupMethod === "neondb") await setupWithNeonDb(projectDir, packageManager, backend);
-		else {
-			const suggestedProjectName = path.basename(projectDir);
-			const projectName = await text({
-				message: "Enter a name for your Neon project:",
-				defaultValue: suggestedProjectName,
-				initialValue: suggestedProjectName
-			});
-			const regionId = await select({
-				message: "Select a region for your Neon project:",
-				options: NEON_REGIONS,
-				initialValue: NEON_REGIONS[0].value
-			});
-			if (isCancel(projectName) || isCancel(regionId)) return exitCancelled("Operation cancelled");
-			const neonConfig = await createNeonProject(projectName, regionId, packageManager);
-			if (!neonConfig) throw new Error("Failed to create project - couldn't get connection information");
-			const finalSpinner = spinner();
-			finalSpinner.start("Configuring database connection");
-			await writeEnvFile$2(projectDir, backend, neonConfig);
-			finalSpinner.stop("Neon database configured!");
+	const target = backend === "self" ? "apps/web" : "apps/server";
+	if (manualDb) {
+		const envResult$1 = await writeEnvFile$2(projectDir, backend);
+		if (envResult$1.isErr()) return envResult$1;
+		displayManualSetupInstructions$2(target);
+		return Result.ok(void 0);
+	}
+	const mode = await select({
+		message: "Neon setup: choose mode",
+		options: [{
+			label: "Automatic",
+			value: "auto",
+			hint: "Automated setup with provider CLI, sets .env"
+		}, {
+			label: "Manual",
+			value: "manual",
+			hint: "Manual setup, add env vars yourself"
+		}],
+		initialValue: "auto"
+	});
+	if (isCancel(mode)) return userCancelled("Operation cancelled");
+	if (mode === "manual") {
+		const envResult$1 = await writeEnvFile$2(projectDir, backend);
+		if (envResult$1.isErr()) return envResult$1;
+		displayManualSetupInstructions$2(target);
+		return Result.ok(void 0);
+	}
+	const setupMethod = await select({
+		message: "Choose your Neon setup method:",
+		options: [{
+			label: "Quick setup with get-db",
+			value: "neondb",
+			hint: "fastest, no auth required"
+		}, {
+			label: "Custom setup with neonctl",
+			value: "neonctl",
+			hint: "More control - choose project name and region"
+		}],
+		initialValue: "neondb"
+	});
+	if (isCancel(setupMethod)) return userCancelled("Operation cancelled");
+	if (setupMethod === "neondb") {
+		const neonDbResult = await setupWithNeonDb(projectDir, packageManager, backend);
+		if (neonDbResult.isErr()) {
+			log.error(pc.red(neonDbResult.error.message));
+			const envResult$1 = await writeEnvFile$2(projectDir, backend);
+			if (envResult$1.isErr()) return envResult$1;
+			displayManualSetupInstructions$2(target);
 		}
-	} catch (error) {
-		if (error instanceof Error) consola$1.error(pc.red(error.message));
-		await writeEnvFile$2(projectDir, backend);
-		displayManualSetupInstructions$2(backend === "self" ? "apps/web" : "apps/server");
+		return neonDbResult;
+	}
+	const suggestedProjectName = path.basename(projectDir);
+	const projectName = await text({
+		message: "Enter a name for your Neon project:",
+		defaultValue: suggestedProjectName,
+		initialValue: suggestedProjectName
+	});
+	if (isCancel(projectName)) return userCancelled("Operation cancelled");
+	const regionId = await select({
+		message: "Select a region for your Neon project:",
+		options: NEON_REGIONS,
+		initialValue: NEON_REGIONS[0].value
+	});
+	if (isCancel(regionId)) return userCancelled("Operation cancelled");
+	const neonConfigResult = await createNeonProject(projectName, regionId, packageManager);
+	if (neonConfigResult.isErr()) {
+		log.error(pc.red(neonConfigResult.error.message));
+		const envResult$1 = await writeEnvFile$2(projectDir, backend);
+		if (envResult$1.isErr()) return envResult$1;
+		displayManualSetupInstructions$2(target);
+		return Result.ok(void 0);
+	}
+	const finalSpinner = spinner();
+	finalSpinner.start("Configuring database connection");
+	const envResult = await writeEnvFile$2(projectDir, backend, neonConfigResult.value);
+	if (envResult.isErr()) {
+		finalSpinner.stop(pc.red("Failed to configure database connection"));
+		return envResult;
 	}
+	finalSpinner.stop("Neon database configured!");
+	return Result.ok(void 0);
 }
 
 //#endregion
@@ -3296,53 +3616,70 @@ const AVAILABLE_REGIONS = [
 	}
 ];
 async function setupWithCreateDb(serverDir, packageManager) {
-	try {
-		log.info("Starting Prisma Postgres setup with create-db.");
-		const selectedRegion = await select({
-			message: "Select your preferred region:",
-			options: AVAILABLE_REGIONS,
-			initialValue: "ap-southeast-1"
-		});
-		if (isCancel(selectedRegion)) return null;
-		const createDbArgs = getPackageExecutionArgs(packageManager, `create-db@latest --json --region ${selectedRegion}`);
-		const s = spinner();
-		s.start("Creating Prisma Postgres database...");
-		const { stdout } = await $({ cwd: serverDir })`${createDbArgs}`;
-		s.stop("Database created successfully!");
-		let createDbResponse;
-		try {
-			createDbResponse = JSON.parse(stdout);
-		} catch {
-			consola$1.error("Failed to parse create-db response");
-			return null;
+	log.info("Starting Prisma Postgres setup with create-db.");
+	const selectedRegion = await select({
+		message: "Select your preferred region:",
+		options: AVAILABLE_REGIONS,
+		initialValue: "ap-southeast-1"
+	});
+	if (isCancel(selectedRegion)) return userCancelled("Operation cancelled");
+	const createDbArgs = getPackageExecutionArgs(packageManager, `create-db@latest --json --region ${selectedRegion}`);
+	const s = spinner();
+	s.start("Creating Prisma Postgres database...");
+	const execResult = await Result.tryPromise({
+		try: async () => {
+			const { stdout } = await $({ cwd: serverDir })`${createDbArgs}`;
+			s.stop("Database created successfully!");
+			return stdout;
+		},
+		catch: (e) => {
+			s.stop(pc.red("Failed to create database"));
+			return new DatabaseSetupError({
+				provider: "prisma-postgres",
+				message: `Failed to create database: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
 		}
-		return {
-			databaseUrl: createDbResponse.connectionString,
-			claimUrl: createDbResponse.claimUrl
-		};
-	} catch (error) {
-		if (error instanceof Error) consola$1.error(error.message);
-		return null;
-	}
+	});
+	if (execResult.isErr()) return execResult;
+	const parseResult = Result.try({
+		try: () => JSON.parse(execResult.value),
+		catch: (e) => new DatabaseSetupError({
+			provider: "prisma-postgres",
+			message: `Failed to parse create-db response: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (parseResult.isErr()) return parseResult;
+	const createDbResponse = parseResult.value;
+	return Result.ok({
+		databaseUrl: createDbResponse.connectionString,
+		claimUrl: createDbResponse.claimUrl
+	});
 }
 async function writeEnvFile$1(projectDir, backend, config) {
-	try {
-		const targetApp = backend === "self" ? "apps/web" : "apps/server";
-		const envPath = path.join(projectDir, targetApp, ".env");
-		const variables = [{
-			key: "DATABASE_URL",
-			value: config?.databaseUrl ?? "postgresql://postgres:postgres@localhost:5432/mydb?schema=public",
-			condition: true
-		}];
-		if (config?.claimUrl) variables.push({
-			key: "CLAIM_URL",
-			value: config.claimUrl,
-			condition: true
-		});
-		await addEnvVariablesToFile(envPath, variables);
-	} catch {
-		consola$1.error("Failed to update environment configuration");
-	}
+	return Result.tryPromise({
+		try: async () => {
+			const targetApp = backend === "self" ? "apps/web" : "apps/server";
+			const envPath = path.join(projectDir, targetApp, ".env");
+			const variables = [{
+				key: "DATABASE_URL",
+				value: config?.databaseUrl ?? "postgresql://postgres:postgres@localhost:5432/mydb?schema=public",
+				condition: true
+			}];
+			if (config?.claimUrl) variables.push({
+				key: "CLAIM_URL",
+				value: config.claimUrl,
+				condition: true
+			});
+			await addEnvVariablesToFile(envPath, variables);
+		},
+		catch: (e) => new DatabaseSetupError({
+			provider: "prisma-postgres",
+			message: `Failed to update environment configuration: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 function displayManualSetupInstructions$1(target) {
 	log.info(`Manual Prisma PostgreSQL Setup Instructions:
@@ -3358,124 +3695,134 @@ async function setupPrismaPostgres(config, cliInput) {
 	const { packageManager, projectDir, backend } = config;
 	const manualDb = cliInput?.manualDb ?? false;
 	const dbDir = path.join(projectDir, "packages/db");
-	try {
-		await fs.ensureDir(dbDir);
-		if (manualDb) {
-			await writeEnvFile$1(projectDir, backend);
-			displayManualSetupInstructions$1(backend === "self" ? "apps/web" : "apps/server");
-			return;
-		}
-		const setupMode = await select({
-			message: "Prisma Postgres setup: choose mode",
-			options: [{
-				label: "Automatic (create-db)",
-				value: "auto",
-				hint: "Provision a database via Prisma's create-db CLI"
-			}, {
-				label: "Manual",
-				value: "manual",
-				hint: "Add your own DATABASE_URL later"
-			}],
-			initialValue: "auto"
-		});
-		if (isCancel(setupMode)) return;
-		if (setupMode === "manual") {
-			await writeEnvFile$1(projectDir, backend);
-			displayManualSetupInstructions$1(backend === "self" ? "apps/web" : "apps/server");
-			return;
-		}
-		const prismaConfig = await setupWithCreateDb(dbDir, packageManager);
-		if (prismaConfig) {
-			await writeEnvFile$1(projectDir, backend, prismaConfig);
-			log.success(pc.green("Prisma Postgres database configured successfully!"));
-			if (prismaConfig.claimUrl) log.info(pc.blue(`Claim URL saved to .env: ${prismaConfig.claimUrl}`));
-		} else {
-			await writeEnvFile$1(projectDir, backend);
-			displayManualSetupInstructions$1(backend === "self" ? "apps/web" : "apps/server");
-		}
-	} catch (error) {
-		consola$1.error(pc.red(`Error during Prisma Postgres setup: ${error instanceof Error ? error.message : String(error)}`));
-		try {
-			await writeEnvFile$1(projectDir, backend);
-			displayManualSetupInstructions$1(backend === "self" ? "apps/web" : "apps/server");
-		} catch {}
+	const target = backend === "self" ? "apps/web" : "apps/server";
+	const ensureDirResult = await Result.tryPromise({
+		try: () => fs.ensureDir(dbDir),
+		catch: (e) => new DatabaseSetupError({
+			provider: "prisma-postgres",
+			message: `Failed to create directory: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (ensureDirResult.isErr()) return ensureDirResult;
+	if (manualDb) {
+		const envResult$1 = await writeEnvFile$1(projectDir, backend);
+		if (envResult$1.isErr()) return envResult$1;
+		displayManualSetupInstructions$1(target);
+		return Result.ok(void 0);
+	}
+	const setupMode = await select({
+		message: "Prisma Postgres setup: choose mode",
+		options: [{
+			label: "Automatic (create-db)",
+			value: "auto",
+			hint: "Provision a database via Prisma's create-db CLI"
+		}, {
+			label: "Manual",
+			value: "manual",
+			hint: "Add your own DATABASE_URL later"
+		}],
+		initialValue: "auto"
+	});
+	if (isCancel(setupMode)) return userCancelled("Operation cancelled");
+	if (setupMode === "manual") {
+		const envResult$1 = await writeEnvFile$1(projectDir, backend);
+		if (envResult$1.isErr()) return envResult$1;
+		displayManualSetupInstructions$1(target);
+		return Result.ok(void 0);
+	}
+	const prismaConfigResult = await setupWithCreateDb(dbDir, packageManager);
+	if (prismaConfigResult.isErr()) {
+		if (UserCancelledError.is(prismaConfigResult.error)) return prismaConfigResult;
+		log.error(pc.red(prismaConfigResult.error.message));
+		const envResult$1 = await writeEnvFile$1(projectDir, backend);
+		if (envResult$1.isErr()) return envResult$1;
+		displayManualSetupInstructions$1(target);
 		log.info("Setup completed with manual configuration required.");
+		return Result.ok(void 0);
 	}
+	const envResult = await writeEnvFile$1(projectDir, backend, prismaConfigResult.value);
+	if (envResult.isErr()) return envResult;
+	log.success(pc.green("Prisma Postgres database configured successfully!"));
+	if (prismaConfigResult.value.claimUrl) log.info(pc.blue(`Claim URL saved to .env: ${prismaConfigResult.value.claimUrl}`));
+	return Result.ok(void 0);
 }
 
 //#endregion
 //#region src/helpers/database-providers/supabase-setup.ts
 async function writeSupabaseEnvFile(projectDir, backend, databaseUrl) {
-	try {
-		const targetApp = backend === "self" ? "apps/web" : "apps/server";
-		const envPath = path.join(projectDir, targetApp, ".env");
-		const dbUrlToUse = databaseUrl || "postgresql://postgres:postgres@127.0.0.1:54322/postgres";
-		await addEnvVariablesToFile(envPath, [{
-			key: "DATABASE_URL",
-			value: dbUrlToUse,
-			condition: true
-		}, {
-			key: "DIRECT_URL",
-			value: dbUrlToUse,
-			condition: true
-		}]);
-		return true;
-	} catch (error) {
-		consola$1.error(pc.red("Failed to update .env file for Supabase."));
-		if (error instanceof Error) consola$1.error(error.message);
-		return false;
-	}
+	return Result.tryPromise({
+		try: async () => {
+			const targetApp = backend === "self" ? "apps/web" : "apps/server";
+			const envPath = path.join(projectDir, targetApp, ".env");
+			const dbUrlToUse = databaseUrl || "postgresql://postgres:postgres@127.0.0.1:54322/postgres";
+			await addEnvVariablesToFile(envPath, [{
+				key: "DATABASE_URL",
+				value: dbUrlToUse,
+				condition: true
+			}, {
+				key: "DIRECT_URL",
+				value: dbUrlToUse,
+				condition: true
+			}]);
+		},
+		catch: (e) => new DatabaseSetupError({
+			provider: "supabase",
+			message: `Failed to update .env file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 function extractDbUrl(output) {
-	const url = output.match(/DB URL:\s*(postgresql:\/\/[^\s]+)/)?.[1];
-	if (url) return url;
-	return null;
+	return output.match(/DB URL:\s*(postgresql:\/\/[^\s]+)/)?.[1] ?? null;
 }
 async function initializeSupabase(serverDir, packageManager) {
 	log.info("Initializing Supabase project...");
-	try {
-		const supabaseInitArgs = getPackageExecutionArgs(packageManager, "supabase init");
-		await $({
-			cwd: serverDir,
-			stdio: "inherit"
-		})`${supabaseInitArgs}`;
-		log.success("Supabase project initialized");
-		return true;
-	} catch (error) {
-		consola$1.error(pc.red("Failed to initialize Supabase project."));
-		if (error instanceof Error) consola$1.error(error.message);
-		else consola$1.error(String(error));
-		if (error instanceof Error && error.message.includes("ENOENT")) {
-			log.error(pc.red("Supabase CLI not found. Please install it globally or ensure it's in your PATH."));
-			log.info("You can install it using: npm install -g supabase");
+	return Result.tryPromise({
+		try: async () => {
+			const supabaseInitArgs = getPackageExecutionArgs(packageManager, "supabase init");
+			await execa(supabaseInitArgs[0], supabaseInitArgs.slice(1), {
+				cwd: serverDir,
+				stdio: "inherit"
+			});
+			log.success("Supabase project initialized");
+		},
+		catch: (e) => {
+			const error = e;
+			return new DatabaseSetupError({
+				provider: "supabase",
+				message: error.message?.includes("ENOENT") ? "Supabase CLI not found. Please install it globally (npm install -g supabase) or ensure it's in your PATH." : `Failed to initialize Supabase project: ${error.message ?? String(e)}`,
+				cause: e
+			});
 		}
-		return false;
-	}
+	});
 }
 async function startSupabase(serverDir, packageManager) {
 	log.info("Starting Supabase services (this may take a moment)...");
 	const supabaseStartArgs = getPackageExecutionArgs(packageManager, "supabase start");
-	try {
-		const subprocess = execa(supabaseStartArgs[0], supabaseStartArgs.slice(1), { cwd: serverDir });
-		let stdoutData = "";
-		if (subprocess.stdout) subprocess.stdout.on("data", (data) => {
-			const text$1 = data.toString();
-			process.stdout.write(text$1);
-			stdoutData += text$1;
-		});
-		if (subprocess.stderr) subprocess.stderr.pipe(process.stderr);
-		await subprocess;
-		await new Promise((resolve) => setTimeout(resolve, 100));
-		return stdoutData;
-	} catch (error) {
-		consola$1.error(pc.red("Failed to start Supabase services."));
-		const execaError = error;
-		if (execaError?.message) {
-			consola$1.error(`Error details: ${execaError.message}`);
-			if (execaError.message.includes("Docker is not running")) log.error(pc.red("Docker is not running. Please start Docker and try again."));
-		} else consola$1.error(String(error));
-		return null;
-	}
+	return Result.tryPromise({
+		try: async () => {
+			const subprocess = execa(supabaseStartArgs[0], supabaseStartArgs.slice(1), { cwd: serverDir });
+			let stdoutData = "";
+			if (subprocess.stdout) subprocess.stdout.on("data", (data) => {
+				const text$1 = data.toString();
+				process.stdout.write(text$1);
+				stdoutData += text$1;
+			});
+			if (subprocess.stderr) subprocess.stderr.pipe(process.stderr);
+			await subprocess;
+			await new Promise((resolve) => setTimeout(resolve, 100));
+			return stdoutData;
+		},
+		catch: (e) => {
+			const execaError = e;
+			return new DatabaseSetupError({
+				provider: "supabase",
+				message: execaError?.message?.includes("Docker is not running") ? "Docker is not running. Please start Docker and try again." : `Failed to start Supabase services: ${execaError?.message ?? String(e)}`,
+				cause: e
+			});
+		}
+	});
 }
 function displayManualSupabaseInstructions(output) {
 	log.info(`"Manual Supabase Setup Instructions:"
@@ -3493,56 +3840,63 @@ async function setupSupabase(config, cliInput) {
 	const { projectDir, packageManager, backend } = config;
 	const manualDb = cliInput?.manualDb ?? false;
 	const serverDir = path.join(projectDir, "packages", "db");
-	try {
-		await fs.ensureDir(serverDir);
-		if (manualDb) {
-			displayManualSupabaseInstructions();
-			await writeSupabaseEnvFile(projectDir, backend, "");
-			return;
-		}
-		const mode = await select({
-			message: "Supabase setup: choose mode",
-			options: [{
-				label: "Automatic",
-				value: "auto",
-				hint: "Automated setup with provider CLI, sets .env"
-			}, {
-				label: "Manual",
-				value: "manual",
-				hint: "Manual setup, add env vars yourself"
-			}],
-			initialValue: "auto"
-		});
-		if (isCancel(mode)) return exitCancelled("Operation cancelled");
-		if (mode === "manual") {
-			displayManualSupabaseInstructions();
-			await writeSupabaseEnvFile(projectDir, backend, "");
-			return;
-		}
-		if (!await initializeSupabase(serverDir, packageManager)) {
-			displayManualSupabaseInstructions();
-			return;
-		}
-		const supabaseOutput = await startSupabase(serverDir, packageManager);
-		if (!supabaseOutput) {
-			displayManualSupabaseInstructions();
-			return;
-		}
-		const dbUrl = extractDbUrl(supabaseOutput);
-		if (dbUrl) if (await writeSupabaseEnvFile(projectDir, backend, dbUrl)) log.success(pc.green("Supabase local development setup ready!"));
+	const ensureDirResult = await Result.tryPromise({
+		try: () => fs.ensureDir(serverDir),
+		catch: (e) => new DatabaseSetupError({
+			provider: "supabase",
+			message: `Failed to create directory: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (ensureDirResult.isErr()) return ensureDirResult;
+	if (manualDb) {
+		displayManualSupabaseInstructions();
+		return writeSupabaseEnvFile(projectDir, backend, "");
+	}
+	const mode = await select({
+		message: "Supabase setup: choose mode",
+		options: [{
+			label: "Automatic",
+			value: "auto",
+			hint: "Automated setup with provider CLI, sets .env"
+		}, {
+			label: "Manual",
+			value: "manual",
+			hint: "Manual setup, add env vars yourself"
+		}],
+		initialValue: "auto"
+	});
+	if (isCancel(mode)) return userCancelled("Operation cancelled");
+	if (mode === "manual") {
+		displayManualSupabaseInstructions();
+		return writeSupabaseEnvFile(projectDir, backend, "");
+	}
+	const initResult = await initializeSupabase(serverDir, packageManager);
+	if (initResult.isErr()) {
+		log.error(pc.red(initResult.error.message));
+		displayManualSupabaseInstructions();
+		return writeSupabaseEnvFile(projectDir, backend, "");
+	}
+	const startResult = await startSupabase(serverDir, packageManager);
+	if (startResult.isErr()) {
+		log.error(pc.red(startResult.error.message));
+		displayManualSupabaseInstructions();
+		return writeSupabaseEnvFile(projectDir, backend, "");
+	}
+	const supabaseOutput = startResult.value;
+	const dbUrl = extractDbUrl(supabaseOutput);
+	if (dbUrl) {
+		const envResult = await writeSupabaseEnvFile(projectDir, backend, dbUrl);
+		if (envResult.isOk()) log.success(pc.green("Supabase local development setup ready!"));
 		else {
 			log.error(pc.red("Supabase setup completed, but failed to update .env automatically."));
 			displayManualSupabaseInstructions(supabaseOutput);
 		}
-		else {
-			log.error(pc.yellow("Supabase started, but could not extract DB URL automatically."));
-			displayManualSupabaseInstructions(supabaseOutput);
-		}
-	} catch (error) {
-		if (error instanceof Error) consola$1.error(pc.red(`Error during Supabase setup: ${error.message}`));
-		else consola$1.error(pc.red(`An unknown error occurred during Supabase setup: ${String(error)}`));
-		displayManualSupabaseInstructions();
+		return envResult;
 	}
+	log.error(pc.yellow("Supabase started, but could not extract DB URL automatically."));
+	displayManualSupabaseInstructions(supabaseOutput);
+	return databaseSetupError("supabase", "Could not extract database URL from Supabase output. Please configure manually.");
 }
 
 //#endregion
@@ -3551,76 +3905,92 @@ async function isTursoInstalled() {
 	return commandExists("turso");
 }
 async function isTursoLoggedIn() {
-	try {
-		return !(await $`turso auth whoami`).stdout.includes("You are not logged in");
-	} catch {
-		return false;
-	}
+	const result = await Result.tryPromise({
+		try: async () => {
+			return !(await $`turso auth whoami`).stdout.includes("You are not logged in");
+		},
+		catch: () => false
+	});
+	return result.isOk() ? result.value : false;
 }
 async function loginToTurso() {
 	const s = spinner();
-	try {
-		s.start("Logging in to Turso...");
-		await $`turso auth login`;
-		s.stop("Logged into Turso");
-		return true;
-	} catch {
-		s.stop(pc.red("Failed to log in to Turso"));
-	}
+	s.start("Logging in to Turso...");
+	return Result.tryPromise({
+		try: async () => {
+			await $`turso auth login`;
+			s.stop("Logged into Turso");
+		},
+		catch: (e) => {
+			s.stop(pc.red("Failed to log in to Turso"));
+			return new DatabaseSetupError({
+				provider: "turso",
+				message: `Failed to log in to Turso: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
+		}
+	});
 }
 async function installTursoCLI(isMac) {
 	const s = spinner();
-	try {
-		s.start("Installing Turso CLI...");
-		if (isMac) await $`brew install tursodatabase/tap/turso`;
-		else {
-			const { stdout: installScript } = await $`curl -sSfL https://get.tur.so/install.sh`;
-			await $`bash -c '${installScript}'`;
-		}
-		s.stop("Turso CLI installed");
-		return true;
-	} catch (error) {
-		if (error instanceof Error && error.message.includes("User force closed")) {
-			s.stop("Turso CLI installation cancelled");
-			log.warn(pc.yellow("Turso CLI installation cancelled by user"));
-			throw new Error("Installation cancelled");
+	s.start("Installing Turso CLI...");
+	return Result.tryPromise({
+		try: async () => {
+			if (isMac) await $`brew install tursodatabase/tap/turso`;
+			else {
+				const { stdout: installScript } = await $`curl -sSfL https://get.tur.so/install.sh`;
+				await $`bash -c '${installScript}'`;
+			}
+			s.stop("Turso CLI installed");
+		},
+		catch: (e) => {
+			const error = e;
+			const isCancelled = error.message?.includes("User force closed");
+			s.stop(isCancelled ? "Turso CLI installation cancelled" : pc.red("Failed to install Turso CLI"));
+			return new DatabaseSetupError({
+				provider: "turso",
+				message: isCancelled ? "Installation cancelled by user" : `Failed to install Turso CLI: ${error.message ?? String(e)}`,
+				cause: e
+			});
 		}
-		s.stop(pc.red("Failed to install Turso CLI"));
-	}
+	});
 }
 async function getTursoGroups() {
 	const s = spinner();
-	try {
-		s.start("Fetching Turso groups...");
-		const { stdout } = await $`turso group list`;
-		const lines = stdout.trim().split("\n");
-		if (lines.length <= 1) {
-			s.stop("No Turso groups found");
+	s.start("Fetching Turso groups...");
+	const result = await Result.tryPromise({
+		try: async () => {
+			const { stdout } = await $`turso group list`;
+			const lines = stdout.trim().split("\n");
+			if (lines.length <= 1) {
+				s.stop("No Turso groups found");
+				return [];
+			}
+			const groups = lines.slice(1).map((line) => {
+				const [name, locations, version, status] = line.trim().split(/\s{2,}/);
+				return {
+					name,
+					locations,
+					version,
+					status
+				};
+			});
+			s.stop(`Found ${groups.length} Turso groups`);
+			return groups;
+		},
+		catch: () => {
+			s.stop(pc.red("Error fetching Turso groups"));
 			return [];
 		}
-		const groups = lines.slice(1).map((line) => {
-			const [name, locations, version, status] = line.trim().split(/\s{2,}/);
-			return {
-				name,
-				locations,
-				version,
-				status
-			};
-		});
-		s.stop(`Found ${groups.length} Turso groups`);
-		return groups;
-	} catch (error) {
-		s.stop(pc.red("Error fetching Turso groups"));
-		console.error("Error fetching Turso groups:", error);
-		return [];
-	}
+	});
+	return result.isOk() ? result.value : [];
 }
 async function selectTursoGroup() {
 	const groups = await getTursoGroups();
-	if (groups.length === 0) return null;
+	if (groups.length === 0) return Result.ok(null);
 	if (groups.length === 1) {
 		log.info(`Using the only available group: ${pc.blue(groups[0].name)}`);
-		return groups[0].name;
+		return Result.ok(groups[0].name);
 	}
 	const selectedGroup = await select({
 		message: "Select a Turso database group:",
@@ -3629,44 +3999,75 @@ async function selectTursoGroup() {
 			label: `${group$1.name} (${group$1.locations})`
 		}))
 	});
-	if (isCancel(selectedGroup)) return exitCancelled("Operation cancelled");
-	return selectedGroup;
+	if (isCancel(selectedGroup)) return userCancelled("Operation cancelled");
+	return Result.ok(selectedGroup);
 }
 async function createTursoDatabase(dbName, groupName) {
 	const s = spinner();
-	try {
-		s.start(`Creating Turso database "${dbName}"${groupName ? ` in group "${groupName}"` : ""}...`);
-		if (groupName) await $`turso db create ${dbName} --group ${groupName}`;
-		else await $`turso db create ${dbName}`;
-		s.stop(`Turso database "${dbName}" created`);
-	} catch (error) {
-		s.stop(pc.red(`Failed to create database "${dbName}"`));
-		if (error instanceof Error && error.message.includes("already exists")) throw new Error("DATABASE_EXISTS");
-	}
+	s.start(`Creating Turso database "${dbName}"${groupName ? ` in group "${groupName}"` : ""}...`);
+	const createResult = await Result.tryPromise({
+		try: async () => {
+			if (groupName) await $`turso db create ${dbName} --group ${groupName}`;
+			else await $`turso db create ${dbName}`;
+			s.stop(`Turso database "${dbName}" created`);
+		},
+		catch: (e) => {
+			const error = e;
+			s.stop(pc.red(`Failed to create database "${dbName}"`));
+			if (error.message?.includes("already exists")) return new DatabaseSetupError({
+				provider: "turso",
+				message: "DATABASE_EXISTS",
+				cause: e
+			});
+			return new DatabaseSetupError({
+				provider: "turso",
+				message: `Failed to create database: ${error.message ?? String(e)}`,
+				cause: e
+			});
+		}
+	});
+	if (createResult.isErr()) return createResult;
 	s.start("Retrieving database connection details...");
-	try {
-		const { stdout: dbUrl } = await $`turso db show ${dbName} --url`;
-		const { stdout: authToken } = await $`turso db tokens create ${dbName}`;
-		s.stop("Database connection details retrieved");
-		return {
-			dbUrl: dbUrl.trim(),
-			authToken: authToken.trim()
-		};
-	} catch {
-		s.stop(pc.red("Failed to retrieve database connection details"));
-	}
+	return Result.tryPromise({
+		try: async () => {
+			const { stdout: dbUrl } = await $`turso db show ${dbName} --url`;
+			const { stdout: authToken } = await $`turso db tokens create ${dbName}`;
+			s.stop("Database connection details retrieved");
+			return {
+				dbUrl: dbUrl.trim(),
+				authToken: authToken.trim()
+			};
+		},
+		catch: (e) => {
+			s.stop(pc.red("Failed to retrieve database connection details"));
+			return new DatabaseSetupError({
+				provider: "turso",
+				message: `Failed to retrieve connection details: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			});
+		}
+	});
 }
 async function writeEnvFile(projectDir, backend, config) {
-	const targetApp = backend === "self" ? "apps/web" : "apps/server";
-	await addEnvVariablesToFile(path.join(projectDir, targetApp, ".env"), [{
-		key: "DATABASE_URL",
-		value: config?.dbUrl ?? "",
-		condition: true
-	}, {
-		key: "DATABASE_AUTH_TOKEN",
-		value: config?.authToken ?? "",
-		condition: true
-	}]);
+	return Result.tryPromise({
+		try: async () => {
+			const targetApp = backend === "self" ? "apps/web" : "apps/server";
+			await addEnvVariablesToFile(path.join(projectDir, targetApp, ".env"), [{
+				key: "DATABASE_URL",
+				value: config?.dbUrl ?? "",
+				condition: true
+			}, {
+				key: "DATABASE_AUTH_TOKEN",
+				value: config?.authToken ?? "",
+				condition: true
+			}]);
+		},
+		catch: (e) => new DatabaseSetupError({
+			provider: "turso",
+			message: `Failed to update .env file: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 function displayManualSetupInstructions() {
 	log.info(`Manual Turso Setup Instructions:
@@ -3680,99 +4081,114 @@ DATABASE_URL=your_database_url
 DATABASE_AUTH_TOKEN=your_auth_token`);
 }
 async function setupTurso(config, cliInput) {
-	const { orm, projectDir, backend } = config;
+	const { projectDir, backend } = config;
 	const manualDb = cliInput?.manualDb ?? false;
 	const setupSpinner = spinner();
-	try {
-		if (manualDb) {
-			await writeEnvFile(projectDir, backend);
-			displayManualSetupInstructions();
-			return;
-		}
-		const mode = await select({
-			message: "Turso setup: choose mode",
-			options: [{
-				label: "Automatic",
-				value: "auto",
-				hint: "Automated setup with provider CLI, sets .env"
-			}, {
-				label: "Manual",
-				value: "manual",
-				hint: "Manual setup, add env vars yourself"
-			}],
-			initialValue: "auto"
+	if (manualDb) {
+		const envResult = await writeEnvFile(projectDir, backend);
+		if (envResult.isErr()) return envResult;
+		displayManualSetupInstructions();
+		return Result.ok(void 0);
+	}
+	const mode = await select({
+		message: "Turso setup: choose mode",
+		options: [{
+			label: "Automatic",
+			value: "auto",
+			hint: "Automated setup with provider CLI, sets .env"
+		}, {
+			label: "Manual",
+			value: "manual",
+			hint: "Manual setup, add env vars yourself"
+		}],
+		initialValue: "auto"
+	});
+	if (isCancel(mode)) return userCancelled("Operation cancelled");
+	if (mode === "manual") {
+		const envResult = await writeEnvFile(projectDir, backend);
+		if (envResult.isErr()) return envResult;
+		displayManualSetupInstructions();
+		return Result.ok(void 0);
+	}
+	setupSpinner.start("Checking Turso CLI availability...");
+	const platform = os$1.platform();
+	const isMac = platform === "darwin";
+	if (platform === "win32") {
+		setupSpinner.stop(pc.yellow("Turso setup not supported on Windows"));
+		log.warn(pc.yellow("Automatic Turso setup is not supported on Windows."));
+		const envResult = await writeEnvFile(projectDir, backend);
+		if (envResult.isErr()) return envResult;
+		displayManualSetupInstructions();
+		return Result.ok(void 0);
+	}
+	setupSpinner.stop("Turso CLI availability checked");
+	if (!await isTursoInstalled()) {
+		const shouldInstall = await confirm({
+			message: "Would you like to install Turso CLI?",
+			initialValue: true
 		});
-		if (isCancel(mode)) return exitCancelled("Operation cancelled");
-		if (mode === "manual") {
-			await writeEnvFile(projectDir, backend);
+		if (isCancel(shouldInstall)) return userCancelled("Operation cancelled");
+		if (!shouldInstall) {
+			const envResult = await writeEnvFile(projectDir, backend);
+			if (envResult.isErr()) return envResult;
 			displayManualSetupInstructions();
-			return;
+			return Result.ok(void 0);
 		}
-		setupSpinner.start("Checking Turso CLI availability...");
-		const platform = os$1.platform();
-		const isMac = platform === "darwin";
-		if (platform === "win32") {
-			if (setupSpinner) setupSpinner.stop(pc.yellow("Turso setup not supported on Windows"));
-			log.warn(pc.yellow("Automatic Turso setup is not supported on Windows."));
-			await writeEnvFile(projectDir, backend);
+		const installResult = await installTursoCLI(isMac);
+		if (installResult.isErr()) {
+			log.error(pc.red(installResult.error.message));
+			const envResult = await writeEnvFile(projectDir, backend);
+			if (envResult.isErr()) return envResult;
 			displayManualSetupInstructions();
-			return;
+			return Result.ok(void 0);
 		}
-		if (setupSpinner) setupSpinner.stop("Turso CLI availability checked");
-		if (!await isTursoInstalled()) {
-			const shouldInstall = await confirm({
-				message: "Would you like to install Turso CLI?",
-				initialValue: true
-			});
-			if (isCancel(shouldInstall)) return exitCancelled("Operation cancelled");
-			if (!shouldInstall) {
-				await writeEnvFile(projectDir, backend);
-				displayManualSetupInstructions();
-				return;
-			}
-			await installTursoCLI(isMac);
+	}
+	if (!await isTursoLoggedIn()) {
+		const loginResult = await loginToTurso();
+		if (loginResult.isErr()) {
+			log.error(pc.red(loginResult.error.message));
+			const envResult = await writeEnvFile(projectDir, backend);
+			if (envResult.isErr()) return envResult;
+			displayManualSetupInstructions();
+			return Result.ok(void 0);
 		}
-		if (!await isTursoLoggedIn()) await loginToTurso();
-		const selectedGroup = await selectTursoGroup();
-		let success = false;
-		let dbName = "";
-		let suggestedName = path.basename(projectDir);
-		while (!success) {
-			const dbNameResponse = await text({
-				message: "Enter a name for your database:",
-				defaultValue: suggestedName,
-				initialValue: suggestedName,
-				placeholder: suggestedName
-			});
-			if (isCancel(dbNameResponse)) return exitCancelled("Operation cancelled");
-			dbName = dbNameResponse;
-			try {
-				await writeEnvFile(projectDir, backend, await createTursoDatabase(dbName, selectedGroup));
-				success = true;
-			} catch (error) {
-				if (error instanceof Error && error.message === "DATABASE_EXISTS") {
-					log.warn(pc.yellow(`Database "${pc.red(dbName)}" already exists`));
-					suggestedName = `${dbName}-${Math.floor(Math.random() * 1e3)}`;
-				} else throw error;
+	}
+	const groupResult = await selectTursoGroup();
+	if (groupResult.isErr()) return groupResult;
+	const selectedGroup = groupResult.value;
+	let suggestedName = path.basename(projectDir);
+	while (true) {
+		const dbNameResponse = await text({
+			message: "Enter a name for your database:",
+			defaultValue: suggestedName,
+			initialValue: suggestedName,
+			placeholder: suggestedName
+		});
+		if (isCancel(dbNameResponse)) return userCancelled("Operation cancelled");
+		const dbName = dbNameResponse;
+		const createResult = await createTursoDatabase(dbName, selectedGroup);
+		if (createResult.isErr()) {
+			if (createResult.error.message === "DATABASE_EXISTS") {
+				log.warn(pc.yellow(`Database "${pc.red(dbName)}" already exists`));
+				suggestedName = `${dbName}-${Math.floor(Math.random() * 1e3)}`;
+				continue;
 			}
+			log.error(pc.red(createResult.error.message));
+			const envResult$1 = await writeEnvFile(projectDir, backend);
+			if (envResult$1.isErr()) return envResult$1;
+			displayManualSetupInstructions();
+			log.success("Setup completed with manual configuration required.");
+			return Result.ok(void 0);
 		}
+		const envResult = await writeEnvFile(projectDir, backend, createResult.value);
+		if (envResult.isErr()) return envResult;
 		log.success("Turso database setup completed successfully!");
-	} catch (error) {
-		if (setupSpinner) setupSpinner.stop(pc.red("Turso CLI availability check failed"));
-		consola.error(pc.red(`Error during Turso setup: ${error instanceof Error ? error.message : String(error)}`));
-		await writeEnvFile(projectDir, backend);
-		displayManualSetupInstructions();
-		log.success("Setup completed with manual configuration required.");
+		return Result.ok(void 0);
 	}
 }
 
 //#endregion
 //#region src/helpers/core/db-setup.ts
-/**
-* Database setup - CLI-only operations
-* Calls external database provider CLIs (turso, neon, prisma-postgres, etc.)
-* Dependencies are handled by the generator's db-deps processor
-*/
 async function setupDatabase(config, cliInput) {
 	const { database, dbSetup, backend, projectDir } = config;
 	if (backend === "convex" || database === "none") {
@@ -3784,59 +4200,80 @@ async function setupDatabase(config, cliInput) {
 	}
 	const dbPackageDir = path.join(projectDir, "packages/db");
 	if (!await fs.pathExists(dbPackageDir)) return;
-	try {
-		if (dbSetup === "docker") await setupDockerCompose(config);
-		else if (database === "sqlite" && dbSetup === "turso") await setupTurso(config, cliInput);
-		else if (database === "sqlite" && dbSetup === "d1") await setupCloudflareD1(config);
-		else if (database === "postgres") {
-			if (dbSetup === "prisma-postgres") await setupPrismaPostgres(config, cliInput);
-			else if (dbSetup === "neon") await setupNeonPostgres(config, cliInput);
-			else if (dbSetup === "planetscale") await setupPlanetScale(config);
-			else if (dbSetup === "supabase") await setupSupabase(config, cliInput);
-		} else if (database === "mysql" && dbSetup === "planetscale") await setupPlanetScale(config);
-		else if (database === "mongodb" && dbSetup === "mongodb-atlas") await setupMongoDBAtlas(config, cliInput);
-	} catch (error) {
-		if (error instanceof Error) consola.error(pc.red(error.message));
+	async function runSetup$1(setupFn) {
+		const result = await setupFn();
+		if (result.isErr()) {
+			if (UserCancelledError.is(result.error)) throw result.error;
+			consola.error(pc.red(result.error.message));
+		}
 	}
+	if (dbSetup === "docker") await runSetup$1(() => setupDockerCompose(config));
+	else if (database === "sqlite" && dbSetup === "turso") await runSetup$1(() => setupTurso(config, cliInput));
+	else if (database === "sqlite" && dbSetup === "d1") await setupCloudflareD1(config);
+	else if (database === "postgres") {
+		if (dbSetup === "prisma-postgres") await runSetup$1(() => setupPrismaPostgres(config, cliInput));
+		else if (dbSetup === "neon") await runSetup$1(() => setupNeonPostgres(config, cliInput));
+		else if (dbSetup === "planetscale") await setupPlanetScale(config);
+		else if (dbSetup === "supabase") await runSetup$1(() => setupSupabase(config, cliInput));
+	} else if (database === "mysql" && dbSetup === "planetscale") await setupPlanetScale(config);
+	else if (database === "mongodb" && dbSetup === "mongodb-atlas") await runSetup$1(() => setupMongoDBAtlas(config, cliInput));
 }
 
 //#endregion
 //#region src/helpers/core/git.ts
 async function initializeGit(projectDir, useGit) {
-	if (!useGit) return;
+	if (!useGit) return Result.ok(void 0);
 	if ((await $({
 		cwd: projectDir,
 		reject: false,
 		stderr: "pipe"
 	})`git --version`).exitCode !== 0) {
 		log.warn(pc.yellow("Git is not installed"));
-		return;
+		return Result.ok(void 0);
 	}
 	const result = await $({
 		cwd: projectDir,
 		reject: false,
 		stderr: "pipe"
 	})`git init`;
-	if (result.exitCode !== 0) throw new Error(`Git initialization failed: ${result.stderr}`);
-	await $({ cwd: projectDir })`git add -A`;
-	await $({ cwd: projectDir })`git commit -m ${"initial commit"}`;
+	if (result.exitCode !== 0) return Result.err(new ProjectCreationError({
+		phase: "git-initialization",
+		message: `Git initialization failed: ${result.stderr}`
+	}));
+	return Result.tryPromise({
+		try: async () => {
+			await $({ cwd: projectDir })`git add -A`;
+			await $({ cwd: projectDir })`git commit -m ${"initial commit"}`;
+		},
+		catch: (e) => new ProjectCreationError({
+			phase: "git-initialization",
+			message: `Git commit failed: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 
 //#endregion
 //#region src/helpers/core/install-dependencies.ts
 async function installDependencies({ projectDir, packageManager }) {
 	const s = spinner();
-	try {
-		s.start(`Running ${packageManager} install...`);
-		await $({
-			cwd: projectDir,
-			stderr: "inherit"
-		})`${packageManager} install`;
-		s.stop("Dependencies installed successfully");
-	} catch (error) {
-		s.stop(pc.red("Failed to install dependencies"));
-		if (error instanceof Error) consola.error(pc.red(`Installation error: ${error.message}`));
-	}
+	s.start(`Running ${packageManager} install...`);
+	const result = await Result.tryPromise({
+		try: async () => {
+			await $({
+				cwd: projectDir,
+				stderr: "inherit"
+			})`${packageManager} install`;
+		},
+		catch: (e) => new ProjectCreationError({
+			phase: "dependency-installation",
+			message: `Installation error: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
+	if (result.isOk()) s.stop("Dependencies installed successfully");
+	else s.stop(pc.red("Failed to install dependencies"));
+	return result;
 }
 
 //#endregion
@@ -3845,12 +4282,14 @@ async function isDockerInstalled() {
 	return commandExists("docker");
 }
 async function isDockerRunning() {
-	try {
-		await $`docker info`;
-		return true;
-	} catch {
-		return false;
-	}
+	const result = await Result.tryPromise({
+		try: async () => {
+			await $`docker info`;
+			return true;
+		},
+		catch: () => false
+	});
+	return result.isOk() ? result.value : false;
 }
 function getDockerInstallInstructions(platform, database) {
 	const isMac = platform === "darwin";
@@ -4063,246 +4502,314 @@ function getAlchemyDeployInstructions(runCmd, webDeploy, serverDeploy, backend)
 
 //#endregion
 //#region src/helpers/core/create-project.ts
+/**
+* Creates a new project with the given configuration.
+* Returns a Result with the project directory path on success, or an error on failure.
+*/
 async function createProject(options, cliInput = {}) {
-	const projectDir = options.projectDir;
-	const isConvex = options.backend === "convex";
-	try {
-		await fs.ensureDir(projectDir);
-		const result = await generateVirtualProject({
+	return Result.gen(async function* () {
+		const projectDir = options.projectDir;
+		const isConvex = options.backend === "convex";
+		yield* Result.await(Result.tryPromise({
+			try: () => fs.ensureDir(projectDir),
+			catch: (e) => new ProjectCreationError({
+				phase: "directory-setup",
+				message: `Failed to create project directory: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			})
+		}));
+		const tree = yield* Result.await(generate({
 			config: options,
 			templates: EMBEDDED_TEMPLATES
-		});
-		if (!result.success || !result.tree) throw new Error(result.error || "Failed to generate project templates");
-		await writeTreeToFilesystem(result.tree, projectDir);
-		await setPackageManagerVersion(projectDir, options.packageManager);
-		if (!isConvex && options.database !== "none") await setupDatabase(options, cliInput);
-		if (options.addons.length > 0 && options.addons[0] !== "none") await setupAddons(options);
-		await writeBtsConfig(options);
-		await formatProject(projectDir);
+		}).then((result) => result.mapError((e) => new ProjectCreationError({
+			phase: e.phase || "template-generation",
+			message: e.message,
+			cause: e
+		}))));
+		yield* Result.await(writeTree(tree, projectDir).then((result) => result.mapError((e) => new ProjectCreationError({
+			phase: "file-writing",
+			message: e.message,
+			cause: e
+		}))));
+		yield* Result.await(setPackageManagerVersion(projectDir, options.packageManager));
+		if (!isConvex && options.database !== "none") yield* Result.await(Result.tryPromise({
+			try: () => setupDatabase(options, cliInput),
+			catch: (e) => new ProjectCreationError({
+				phase: "database-setup",
+				message: `Failed to setup database: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			})
+		}));
+		if (options.addons.length > 0 && options.addons[0] !== "none") yield* Result.await(Result.tryPromise({
+			try: () => setupAddons(options),
+			catch: (e) => new ProjectCreationError({
+				phase: "addons-setup",
+				message: `Failed to setup addons: ${e instanceof Error ? e.message : String(e)}`,
+				cause: e
+			})
+		}));
+		yield* Result.await(writeBtsConfig(options));
+		yield* Result.await(formatProject(projectDir));
 		if (!isSilent()) log.success("Project template successfully scaffolded!");
-		if (options.install) await installDependencies({
+		if (options.install) yield* Result.await(installDependencies({
 			projectDir,
 			packageManager: options.packageManager
-		});
-		await initializeGit(projectDir, options.git);
+		}));
+		yield* Result.await(initializeGit(projectDir, options.git));
 		if (!isSilent()) await displayPostInstallInstructions({
 			...options,
 			depsInstalled: options.install
 		});
-		return projectDir;
-	} catch (error) {
-		if (error instanceof Error) {
-			if (!isSilent()) console.error(error.stack);
-			exitWithError(`Error during project creation: ${error.message}`);
-		} else {
-			if (!isSilent()) console.error(error);
-			exitWithError(`An unexpected error occurred: ${String(error)}`);
-		}
-	}
+		return Result.ok(projectDir);
+	});
 }
 async function setPackageManagerVersion(projectDir, packageManager) {
 	const pkgJsonPath = path.join(projectDir, "package.json");
-	if (!await fs.pathExists(pkgJsonPath)) return;
-	try {
-		const { stdout } = await $`${packageManager} -v`;
-		const version = stdout.trim();
-		const pkgJson = await fs.readJson(pkgJsonPath);
-		pkgJson.packageManager = `${packageManager}@${version}`;
-		await fs.writeJson(pkgJsonPath, pkgJson, { spaces: 2 });
-	} catch {
-		const pkgJson = await fs.readJson(pkgJsonPath);
-		delete pkgJson.packageManager;
-		await fs.writeJson(pkgJsonPath, pkgJson, { spaces: 2 });
-	}
+	if (!await fs.pathExists(pkgJsonPath)) return Result.ok(void 0);
+	const versionResult = await Result.tryPromise({
+		try: async () => {
+			const { stdout } = await $`${packageManager} -v`;
+			return stdout.trim();
+		},
+		catch: () => null
+	});
+	return Result.tryPromise({
+		try: async () => {
+			const pkgJson = await fs.readJson(pkgJsonPath);
+			if (versionResult.isOk() && versionResult.value) pkgJson.packageManager = `${packageManager}@${versionResult.value}`;
+			else delete pkgJson.packageManager;
+			await fs.writeJson(pkgJsonPath, pkgJson, { spaces: 2 });
+		},
+		catch: (e) => new ProjectCreationError({
+			phase: "package-manager-version",
+			message: `Failed to set package manager version: ${e instanceof Error ? e.message : String(e)}`,
+			cause: e
+		})
+	});
 }
 
 //#endregion
 //#region src/helpers/core/command-handlers.ts
+/**
+* Create an empty/failed result
+*/
+function createEmptyResult(timeScaffolded, elapsedTimeMs, error) {
+	return {
+		success: false,
+		projectConfig: {
+			projectName: "",
+			projectDir: "",
+			relativePath: "",
+			database: "none",
+			orm: "none",
+			backend: "none",
+			runtime: "none",
+			frontend: [],
+			addons: [],
+			examples: [],
+			auth: "none",
+			payments: "none",
+			git: false,
+			packageManager: "npm",
+			install: false,
+			dbSetup: "none",
+			api: "none",
+			webDeploy: "none",
+			serverDeploy: "none"
+		},
+		reproducibleCommand: "",
+		timeScaffolded,
+		elapsedTimeMs,
+		projectDirectory: "",
+		relativePath: "",
+		error
+	};
+}
 async function createProjectHandler(input, options = {}) {
 	const { silent = false } = options;
 	return runWithContextAsync({ silent }, async () => {
 		const startTime = Date.now();
 		const timeScaffolded = (/* @__PURE__ */ new Date()).toISOString();
-		try {
-			if (!isSilent() && input.renderTitle !== false) renderTitle();
-			if (!isSilent()) intro(pc.magenta("Creating a new Better-T-Stack project"));
-			if (!isSilent() && input.yolo) consola.fatal("YOLO mode enabled - skipping checks. Things may break!");
-			let currentPathInput;
-			if (input.yes && input.projectName) currentPathInput = input.projectName;
-			else if (input.yes) {
-				const defaultConfig = getDefaultConfig();
-				let defaultName = defaultConfig.relativePath;
-				let counter = 1;
-				while (await fs.pathExists(path.resolve(process.cwd(), defaultName)) && (await fs.readdir(path.resolve(process.cwd(), defaultName))).length > 0) {
-					defaultName = `${defaultConfig.projectName}-${counter}`;
-					counter++;
-				}
-				currentPathInput = defaultName;
-			} else currentPathInput = await getProjectName(input.projectName);
-			let finalPathInput;
-			let shouldClearDirectory;
-			try {
-				if (input.directoryConflict) {
-					const result = await handleDirectoryConflictProgrammatically(currentPathInput, input.directoryConflict);
-					finalPathInput = result.finalPathInput;
-					shouldClearDirectory = result.shouldClearDirectory;
-				} else {
-					const result = await handleDirectoryConflict(currentPathInput);
-					finalPathInput = result.finalPathInput;
-					shouldClearDirectory = result.shouldClearDirectory;
-				}
-			} catch (error) {
-				if (error instanceof UserCancelledError || error instanceof CLIError) throw error;
-				return {
-					success: false,
-					projectConfig: {
-						projectName: "",
-						projectDir: "",
-						relativePath: "",
-						database: "none",
-						orm: "none",
-						backend: "none",
-						runtime: "none",
-						frontend: [],
-						addons: [],
-						examples: [],
-						auth: "none",
-						payments: "none",
-						git: false,
-						packageManager: "npm",
-						install: false,
-						dbSetup: "none",
-						api: "none",
-						webDeploy: "none",
-						serverDeploy: "none"
-					},
-					reproducibleCommand: "",
-					timeScaffolded,
-					elapsedTimeMs: Date.now() - startTime,
-					projectDirectory: "",
-					relativePath: "",
-					error: error instanceof Error ? error.message : String(error)
-				};
+		const result = await createProjectHandlerInternal(input, startTime, timeScaffolded);
+		if (result.isOk()) return result.value;
+		const error = result.error;
+		const elapsedTimeMs = Date.now() - startTime;
+		if (UserCancelledError.is(error)) {
+			if (isSilent()) return createEmptyResult(timeScaffolded, elapsedTimeMs, error.message);
+			return;
+		}
+		if (isSilent()) return createEmptyResult(timeScaffolded, elapsedTimeMs, error.message);
+		displayError(error);
+		process.exit(1);
+	});
+}
+async function createProjectHandlerInternal(input, startTime, timeScaffolded) {
+	return Result.gen(async function* () {
+		if (!isSilent() && input.renderTitle !== false) renderTitle();
+		if (!isSilent()) intro(pc.magenta("Creating a new Better-T-Stack project"));
+		if (!isSilent() && input.yolo) consola.fatal("YOLO mode enabled - skipping checks. Things may break!");
+		let currentPathInput;
+		if (input.yes && input.projectName) currentPathInput = input.projectName;
+		else if (input.yes) {
+			const defaultConfig = getDefaultConfig();
+			let defaultName = defaultConfig.relativePath;
+			let counter = 1;
+			while (await fs.pathExists(path.resolve(process.cwd(), defaultName)) && (await fs.readdir(path.resolve(process.cwd(), defaultName))).length > 0) {
+				defaultName = `${defaultConfig.projectName}-${counter}`;
+				counter++;
 			}
-			const { finalResolvedPath, finalBaseName } = await setupProjectDirectory(finalPathInput, shouldClearDirectory);
-			const originalInput = {
-				...input,
-				projectDirectory: input.projectName
-			};
-			const providedFlags = getProvidedFlags(originalInput);
-			let cliInput = originalInput;
-			if (input.template && input.template !== "none") {
-				const templateConfig = getTemplateConfig(input.template);
-				if (templateConfig) {
-					const templateName = input.template.toUpperCase();
-					const templateDescription = getTemplateDescription(input.template);
-					if (!isSilent()) {
-						log.message(pc.bold(pc.cyan(`Using template: ${pc.white(templateName)}`)));
-						log.message(pc.dim(`   ${templateDescription}`));
-					}
-					const userOverrides = {};
-					for (const [key, value] of Object.entries(originalInput)) if (value !== void 0) userOverrides[key] = value;
-					cliInput = {
-						...templateConfig,
-						...userOverrides,
-						template: input.template,
-						projectDirectory: originalInput.projectDirectory
-					};
-				}
+			currentPathInput = defaultName;
+		} else currentPathInput = yield* Result.await(Result.tryPromise({
+			try: async () => getProjectName(input.projectName),
+			catch: (e) => {
+				if (e instanceof UserCancelledError) return e;
+				return new CLIError({
+					message: e instanceof Error ? e.message : String(e),
+					cause: e
+				});
 			}
-			let config;
-			if (cliInput.yes) {
-				const flagConfig = processProvidedFlagsWithoutValidation(cliInput, finalBaseName);
-				config = {
-					...getDefaultConfig(),
-					...flagConfig,
-					projectName: finalBaseName,
-					projectDir: finalResolvedPath,
-					relativePath: finalPathInput
-				};
-				validateConfigCompatibility(config, providedFlags, cliInput);
+		}));
+		let finalPathInput;
+		let shouldClearDirectory;
+		const conflictResult = yield* Result.await(handleDirectoryConflictResult(currentPathInput, input.directoryConflict));
+		finalPathInput = conflictResult.finalPathInput;
+		shouldClearDirectory = conflictResult.shouldClearDirectory;
+		const { finalResolvedPath, finalBaseName } = yield* Result.await(Result.tryPromise({
+			try: async () => setupProjectDirectory(finalPathInput, shouldClearDirectory),
+			catch: (e) => {
+				if (e instanceof UserCancelledError) return e;
+				return new CLIError({
+					message: e instanceof Error ? e.message : String(e),
+					cause: e
+				});
+			}
+		}));
+		const originalInput = {
+			...input,
+			projectDirectory: input.projectName
+		};
+		const providedFlags = getProvidedFlags(originalInput);
+		let cliInput = originalInput;
+		if (input.template && input.template !== "none") {
+			const templateConfig = getTemplateConfig(input.template);
+			if (templateConfig) {
+				const templateName = input.template.toUpperCase();
+				const templateDescription = getTemplateDescription(input.template);
 				if (!isSilent()) {
-					log.info(pc.yellow("Using default/flag options (config prompts skipped):"));
-					log.message(displayConfig(config));
-				}
-			} else {
-				const flagConfig = processAndValidateFlags(cliInput, providedFlags, finalBaseName);
-				const { projectName: _projectNameFromFlags, ...otherFlags } = flagConfig;
-				if (!isSilent() && Object.keys(otherFlags).length > 0) {
-					log.info(pc.yellow("Using these pre-selected options:"));
-					log.message(displayConfig(otherFlags));
-					log.message("");
+					log.message(pc.bold(pc.cyan(`Using template: ${pc.white(templateName)}`)));
+					log.message(pc.dim(`   ${templateDescription}`));
 				}
-				config = await gatherConfig(flagConfig, finalBaseName, finalResolvedPath, finalPathInput);
-			}
-			await createProject(config, { manualDb: cliInput.manualDb ?? input.manualDb });
-			const reproducibleCommand = generateReproducibleCommand(config);
-			if (!isSilent()) log.success(pc.blue(`You can reproduce this setup with the following command:\n${reproducibleCommand}`));
-			await trackProjectCreation(config, input.disableAnalytics);
-			const elapsedTimeMs = Date.now() - startTime;
-			if (!isSilent()) {
-				const elapsedTimeInSeconds = (elapsedTimeMs / 1e3).toFixed(2);
-				outro(pc.magenta(`Project created successfully in ${pc.bold(elapsedTimeInSeconds)} seconds!`));
+				const userOverrides = {};
+				for (const [key, value] of Object.entries(originalInput)) if (value !== void 0) userOverrides[key] = value;
+				cliInput = {
+					...templateConfig,
+					...userOverrides,
+					template: input.template,
+					projectDirectory: originalInput.projectDirectory
+				};
 			}
-			return {
-				success: true,
-				projectConfig: config,
-				reproducibleCommand,
-				timeScaffolded,
-				elapsedTimeMs,
-				projectDirectory: config.projectDir,
-				relativePath: config.relativePath
+		}
+		let config;
+		if (cliInput.yes) {
+			const flagConfigResult = processProvidedFlagsWithoutValidation(cliInput, finalBaseName);
+			if (flagConfigResult.isErr()) return Result.err(new CLIError({
+				message: flagConfigResult.error.message,
+				cause: flagConfigResult.error
+			}));
+			const flagConfig = flagConfigResult.value;
+			config = {
+				...getDefaultConfig(),
+				...flagConfig,
+				projectName: finalBaseName,
+				projectDir: finalResolvedPath,
+				relativePath: finalPathInput
 			};
-		} catch (error) {
-			if (error instanceof UserCancelledError) {
-				if (isSilent()) return {
-					success: false,
-					error: error.message,
-					projectConfig: {},
-					reproducibleCommand: "",
-					timeScaffolded,
-					elapsedTimeMs: Date.now() - startTime,
-					projectDirectory: "",
-					relativePath: ""
-				};
-				return;
+			const validationResult = validateConfigCompatibility(config, providedFlags, cliInput);
+			if (validationResult.isErr()) return Result.err(new CLIError({
+				message: validationResult.error.message,
+				cause: validationResult.error
+			}));
+			if (!isSilent()) {
+				log.info(pc.yellow("Using default/flag options (config prompts skipped):"));
+				log.message(displayConfig(config));
 			}
-			if (error instanceof CLIError) {
-				if (isSilent()) return {
-					success: false,
-					error: error.message,
-					projectConfig: {},
-					reproducibleCommand: "",
-					timeScaffolded,
-					elapsedTimeMs: Date.now() - startTime,
-					projectDirectory: "",
-					relativePath: ""
-				};
-				throw error;
+		} else {
+			const flagConfigResult = processAndValidateFlags(cliInput, providedFlags, finalBaseName);
+			if (flagConfigResult.isErr()) return Result.err(new CLIError({
+				message: flagConfigResult.error.message,
+				cause: flagConfigResult.error
+			}));
+			const flagConfig = flagConfigResult.value;
+			const { projectName: _projectNameFromFlags, ...otherFlags } = flagConfig;
+			if (!isSilent() && Object.keys(otherFlags).length > 0) {
+				log.info(pc.yellow("Using these pre-selected options:"));
+				log.message(displayConfig(otherFlags));
+				log.message("");
 			}
-			throw error;
+			config = yield* Result.await(Result.tryPromise({
+				try: async () => gatherConfig(flagConfig, finalBaseName, finalResolvedPath, finalPathInput),
+				catch: (e) => {
+					if (e instanceof UserCancelledError) return e;
+					return new CLIError({
+						message: e instanceof Error ? e.message : String(e),
+						cause: e
+					});
+				}
+			}));
+		}
+		yield* Result.await(createProject(config, { manualDb: cliInput.manualDb ?? input.manualDb }));
+		const reproducibleCommand = generateReproducibleCommand(config);
+		if (!isSilent()) log.success(pc.blue(`You can reproduce this setup with the following command:\n${reproducibleCommand}`));
+		await trackProjectCreation(config, input.disableAnalytics);
+		const elapsedTimeMs = Date.now() - startTime;
+		if (!isSilent()) {
+			const elapsedTimeInSeconds = (elapsedTimeMs / 1e3).toFixed(2);
+			outro(pc.magenta(`Project created successfully in ${pc.bold(elapsedTimeInSeconds)} seconds!`));
+		}
+		return Result.ok({
+			success: true,
+			projectConfig: config,
+			reproducibleCommand,
+			timeScaffolded,
+			elapsedTimeMs,
+			projectDirectory: config.projectDir,
+			relativePath: config.relativePath
+		});
+	});
+}
+async function handleDirectoryConflictResult(currentPathInput, strategy) {
+	if (strategy) return handleDirectoryConflictProgrammatically(currentPathInput, strategy);
+	return Result.tryPromise({
+		try: async () => handleDirectoryConflict(currentPathInput),
+		catch: (e) => {
+			if (e instanceof UserCancelledError) return e;
+			if (e instanceof CLIError) return e;
+			return new CLIError({
+				message: e instanceof Error ? e.message : String(e),
+				cause: e
+			});
 		}
 	});
 }
 async function handleDirectoryConflictProgrammatically(currentPathInput, strategy) {
 	const currentPath = path.resolve(process.cwd(), currentPathInput);
-	if (!await fs.pathExists(currentPath)) return {
+	if (!await fs.pathExists(currentPath)) return Result.ok({
 		finalPathInput: currentPathInput,
 		shouldClearDirectory: false
-	};
-	if (!((await fs.readdir(currentPath)).length > 0)) return {
+	});
+	if (!((await fs.readdir(currentPath)).length > 0)) return Result.ok({
 		finalPathInput: currentPathInput,
 		shouldClearDirectory: false
-	};
+	});
 	switch (strategy) {
-		case "overwrite": return {
+		case "overwrite": return Result.ok({
 			finalPathInput: currentPathInput,
 			shouldClearDirectory: true
-		};
-		case "merge": return {
+		});
+		case "merge": return Result.ok({
 			finalPathInput: currentPathInput,
 			shouldClearDirectory: false
-		};
+		});
 		case "increment": {
 			let counter = 1;
 			const baseName = currentPathInput;
@@ -4311,13 +4818,13 @@ async function handleDirectoryConflictProgrammatically(currentPathInput, strateg
 				counter++;
 				finalPathInput = `${baseName}-${counter}`;
 			}
-			return {
+			return Result.ok({
 				finalPathInput,
 				shouldClearDirectory: false
-			};
+			});
 		}
-		case "error": throw new Error(`Directory "${currentPathInput}" already exists and is not empty. Use directoryConflict: "overwrite", "merge", or "increment" to handle this.`);
-		default: throw new Error(`Unknown directory conflict strategy: ${strategy}`);
+		case "error": return Result.err(new DirectoryConflictError({ directory: currentPathInput }));
+		default: return Result.err(new DirectoryConflictError({ directory: currentPathInput }));
 	}
 }
 
@@ -4325,15 +4832,16 @@ async function handleDirectoryConflictProgrammatically(currentPathInput, strateg
 //#region src/utils/open-url.ts
 async function openUrl(url) {
 	const platform = process.platform;
-	try {
-		if (platform === "darwin") await $({ stdio: "ignore" })`open ${url}`;
-		else if (platform === "win32") {
-			const escapedUrl = url.replace(/&/g, "^&");
-			await $({ stdio: "ignore" })`cmd /c start "" ${escapedUrl}`;
-		} else await $({ stdio: "ignore" })`xdg-open ${url}`;
-	} catch {
-		log.message(`Please open ${url} in your browser.`);
-	}
+	if ((await Result.tryPromise({
+		try: async () => {
+			if (platform === "darwin") await $({ stdio: "ignore" })`open ${url}`;
+			else if (platform === "win32") {
+				const escapedUrl = url.replace(/&/g, "^&");
+				await $({ stdio: "ignore" })`cmd /c start "" ${escapedUrl}`;
+			} else await $({ stdio: "ignore" })`xdg-open ${url}`;
+		},
+		catch: () => void 0
+	})).isErr()) log.message(`Please open ${url} in your browser.`);
 }
 
 //#endregion
@@ -4418,31 +4926,37 @@ const router = os.router({
 		if (options.verbose) return result;
 	}),
 	sponsors: os.meta({ description: "Show Better-T-Stack sponsors" }).handler(async () => {
-		try {
-			renderTitle();
-			intro(pc.magenta("Better-T-Stack Sponsors"));
-			displaySponsors(await fetchSponsors());
-		} catch (error) {
-			handleError(error, "Failed to display sponsors");
+		const result = await Result.tryPromise({
+			try: async () => {
+				renderTitle();
+				intro(pc.magenta("Better-T-Stack Sponsors"));
+				displaySponsors(await fetchSponsors());
+			},
+			catch: (e) => new CLIError({
+				message: e instanceof Error ? e.message : "Failed to display sponsors",
+				cause: e
+			})
+		});
+		if (result.isErr()) {
+			displayError(result.error);
+			process.exit(1);
 		}
 	}),
 	docs: os.meta({ description: "Open Better-T-Stack documentation" }).handler(async () => {
 		const DOCS_URL = "https://better-t-stack.dev/docs";
-		try {
-			await openUrl(DOCS_URL);
-			log.success(pc.blue("Opened docs in your default browser."));
-		} catch {
-			log.message(`Please visit ${DOCS_URL}`);
-		}
+		if ((await Result.tryPromise({
+			try: () => openUrl(DOCS_URL),
+			catch: () => null
+		})).isOk()) log.success(pc.blue("Opened docs in your default browser."));
+		else log.message(`Please visit ${DOCS_URL}`);
 	}),
 	builder: os.meta({ description: "Open the web-based stack builder" }).handler(async () => {
 		const BUILDER_URL = "https://better-t-stack.dev/new";
-		try {
-			await openUrl(BUILDER_URL);
-			log.success(pc.blue("Opened builder in your default browser."));
-		} catch {
-			log.message(`Please visit ${BUILDER_URL}`);
-		}
+		if ((await Result.tryPromise({
+			try: () => openUrl(BUILDER_URL),
+			catch: () => null
+		})).isOk()) log.success(pc.blue("Opened builder in your default browser."));
+		else log.message(`Please visit ${BUILDER_URL}`);
 	})
 });
 const caller = createRouterClient(router, { context: {} });
@@ -4455,11 +4969,11 @@ function createBtsCli() {
 }
 /**
 * Programmatic API to create a new Better-T-Stack project.
-* Returns pure JSON - no console output, no interactive prompts.
+* Returns a Result type - no console output, no interactive prompts.
 *
 * @example
 * ```typescript
-* import { create } from "create-better-t-stack";
+* import { create, Result } from "create-better-t-stack";
 *
 * const result = await create("my-app", {
 *   frontend: ["tanstack-router"],
@@ -4469,9 +4983,13 @@ function createBtsCli() {
 *   orm: "drizzle",
 * });
 *
-* if (result.success) {
-*   console.log(`Project created at: ${result.projectDirectory}`);
-* }
+* result.match({
+*   ok: (data) => console.log(`Project created at: ${data.projectDirectory}`),
+*   err: (error) => console.error(`Failed: ${error.message}`),
+* });
+*
+* // Or use unwrapOr for a default value
+* const data = result.unwrapOr(null);
 * ```
 */
 async function create(projectName, options) {
@@ -4483,20 +5001,23 @@ async function create(projectName, options) {
 		disableAnalytics: options?.disableAnalytics ?? true,
 		directoryConflict: options?.directoryConflict ?? "error"
 	};
-	try {
-		return await createProjectHandler(input, { silent: true });
-	} catch (error) {
-		return {
-			success: false,
-			error: error instanceof Error ? error.message : String(error),
-			projectConfig: {},
-			reproducibleCommand: "",
-			timeScaffolded: (/* @__PURE__ */ new Date()).toISOString(),
-			elapsedTimeMs: 0,
-			projectDirectory: "",
-			relativePath: ""
-		};
-	}
+	return Result.tryPromise({
+		try: async () => {
+			const result = await createProjectHandler(input, { silent: true });
+			if (!result) throw new UserCancelledError({ message: "Operation cancelled" });
+			if (!result.success) throw new CLIError({ message: result.error || "Unknown error occurred" });
+			return result;
+		},
+		catch: (e) => {
+			if (e instanceof UserCancelledError) return e;
+			if (e instanceof CLIError) return e;
+			if (e instanceof ProjectCreationError) return e;
+			return new CLIError({
+				message: e instanceof Error ? e.message : String(e),
+				cause: e
+			});
+		}
+	});
 }
 async function sponsors() {
 	return caller.sponsors();
@@ -4509,12 +5030,12 @@ async function builder() {
 }
 /**
 * Programmatic API to generate a project in-memory (virtual filesystem).
-* Returns a VirtualFileTree without writing to disk.
+* Returns a Result with a VirtualFileTree without writing to disk.
 * Useful for web previews and testing.
 *
 * @example
 * ```typescript
-* import { createVirtual, EMBEDDED_TEMPLATES } from "create-better-t-stack";
+* import { createVirtual, EMBEDDED_TEMPLATES, Result } from "create-better-t-stack";
 *
 * const result = await createVirtual({
 *   frontend: ["tanstack-router"],
@@ -4524,52 +5045,38 @@ async function builder() {
 *   orm: "drizzle",
 * });
 *
-* if (result.success) {
-*   console.log(`Generated ${result.tree.fileCount} files`);
-* }
+* result.match({
+*   ok: (tree) => console.log(`Generated ${tree.fileCount} files`),
+*   err: (error) => console.error(`Failed: ${error.message}`),
+* });
 * ```
 */
 async function createVirtual(options) {
-	try {
-		const result = await generateVirtualProject({
-			config: {
-				projectName: options.projectName || "my-project",
-				projectDir: "/virtual",
-				relativePath: "./virtual",
-				database: options.database || "none",
-				orm: options.orm || "none",
-				backend: options.backend || "hono",
-				runtime: options.runtime || "bun",
-				frontend: options.frontend || ["tanstack-router"],
-				addons: options.addons || [],
-				examples: options.examples || [],
-				auth: options.auth || "none",
-				payments: options.payments || "none",
-				git: options.git ?? false,
-				packageManager: options.packageManager || "bun",
-				install: false,
-				dbSetup: options.dbSetup || "none",
-				api: options.api || "trpc",
-				webDeploy: options.webDeploy || "none",
-				serverDeploy: options.serverDeploy || "none"
-			},
-			templates: EMBEDDED_TEMPLATES
-		});
-		if (result.success && result.tree) return {
-			success: true,
-			tree: result.tree
-		};
-		return {
-			success: false,
-			error: result.error || "Unknown error"
-		};
-	} catch (error) {
-		return {
-			success: false,
-			error: error instanceof Error ? error.message : String(error)
-		};
-	}
+	return generate({
+		config: {
+			projectName: options.projectName || "my-project",
+			projectDir: "/virtual",
+			relativePath: "./virtual",
+			database: options.database || "none",
+			orm: options.orm || "none",
+			backend: options.backend || "hono",
+			runtime: options.runtime || "bun",
+			frontend: options.frontend || ["tanstack-router"],
+			addons: options.addons || [],
+			examples: options.examples || [],
+			auth: options.auth || "none",
+			payments: options.payments || "none",
+			git: options.git ?? false,
+			packageManager: options.packageManager || "bun",
+			install: false,
+			dbSetup: options.dbSetup || "none",
+			api: options.api || "trpc",
+			webDeploy: options.webDeploy || "none",
+			serverDeploy: options.serverDeploy || "none"
+		},
+		templates: EMBEDDED_TEMPLATES
+	});
 }
 
 //#endregion
-export { create as a, docs as c, sponsors as d, builder as i, generateVirtualProject$1 as l, TEMPLATE_COUNT as n, createBtsCli as o, VirtualFileSystem as r, createVirtual as s, EMBEDDED_TEMPLATES$1 as t, router as u };
+export { DirectoryConflictError as _, VirtualFileSystem as a, ValidationError as b, createBtsCli as c, generate$1 as d, router as f, DatabaseSetupError as g, CompatibilityError as h, TEMPLATE_COUNT as i, createVirtual as l, CLIError as m, GeneratorError$1 as n, builder as o, sponsors as p, Result$1 as r, create as s, EMBEDDED_TEMPLATES$1 as t, docs as u, ProjectCreationError as v, UserCancelledError as y };