create-better-fullstack 1.4.16 → 1.5.1

package/README.md

@@ -38,6 +38,7 @@ Configure your stack visually — pick every option from a UI, preview your choi
 --yolo             # Scaffold a random stack — good for exploring
 --template <name>  # Use a preset (t3, mern, pern, uniwind)
 --ecosystem <lang> # Start in rust, python, or go mode
+--version-channel  # Dependency channel: stable, latest, beta
 --no-git           # Skip git initialization
 --no-install       # Skip dependency installation
 --package-manager  # Package manager (bun, pnpm, npm, yarn)

package/dist/cli.mjs

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

package/dist/index.d.mts

@@ -278,6 +278,11 @@ declare const router: {
       yarn: "yarn";
     }>>;
     install: z.ZodOptional<z.ZodBoolean>;
+    versionChannel: z.ZodOptional<z.ZodEnum<{
+      stable: "stable";
+      latest: "latest";
+      beta: "beta";
+    }>>;
     dbSetup: z.ZodOptional<z.ZodEnum<{
       none: "none";
       turso: "turso";
@@ -543,6 +548,7 @@ declare const router: {
       payments: "none" | "polar" | "stripe" | "lemon-squeezy" | "paddle" | "dodo";
       git: boolean;
       packageManager: "bun" | "npm" | "pnpm" | "yarn";
+      versionChannel: "stable" | "latest" | "beta";
       install: boolean;
       dbSetup: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "upstash" | "d1" | "docker";
       api: "none" | "trpc" | "orpc" | "ts-rest" | "garph";
@@ -629,6 +635,7 @@ declare const router: {
       payments: "none" | "polar" | "stripe" | "lemon-squeezy" | "paddle" | "dodo";
       git: boolean;
       packageManager: "bun" | "npm" | "pnpm" | "yarn";
+      versionChannel: "stable" | "latest" | "beta";
       install: boolean;
       dbSetup: "none" | "turso" | "neon" | "prisma-postgres" | "planetscale" | "mongodb-atlas" | "supabase" | "upstash" | "d1" | "docker";
       api: "none" | "trpc" | "orpc" | "ts-rest" | "garph";

package/dist/index.mjs

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

package/dist/{src-BVbxA2WC.mjs → src-hfdQPH0o.mjs}

@@ -67,6 +67,7 @@ const DEFAULT_CONFIG_BASE = {
 	examples: [],
 	git: true,
 	install: true,
+	versionChannel: "stable",
 	dbSetup: "none",
 	backend: "hono",
 	runtime: "bun",
@@ -1288,10 +1289,9 @@ const ADDON_GROUPS = {
 		"tauri",
 		"opentui",
 		"wxt",
-		"ruler",
-		"msw",
-		"storybook"
+		"ruler"
 	],
+	Integrations: ["msw", "storybook"],
 	"AI Agents": ["mcp", "skills"],
 	TanStack: [
 		"tanstack-query",
@@ -1308,6 +1308,7 @@ async function getAddonsChoice(addons, frontends, auth) {
 		Tooling: [],
 		Documentation: [],
 		Extensions: [],
+		Integrations: [],
 		"AI Agents": [],
 		TanStack: []
 	};
@@ -1324,6 +1325,7 @@ async function getAddonsChoice(addons, frontends, auth) {
 		if (ADDON_GROUPS.Tooling.includes(addon)) groupedOptions.Tooling.push(option);
 		else if (ADDON_GROUPS.Documentation.includes(addon)) groupedOptions.Documentation.push(option);
 		else if (ADDON_GROUPS.Extensions.includes(addon)) groupedOptions.Extensions.push(option);
+		else if (ADDON_GROUPS.Integrations.includes(addon)) groupedOptions.Integrations.push(option);
 		else if (ADDON_GROUPS["AI Agents"].includes(addon)) groupedOptions["AI Agents"].push(option);
 		else if (ADDON_GROUPS.TanStack.includes(addon)) groupedOptions.TanStack.push(option);
 	}
@@ -1350,6 +1352,7 @@ async function getAddonsToAdd(frontend, existingAddons = [], auth) {
 		Tooling: [],
 		Documentation: [],
 		Extensions: [],
+		Integrations: [],
 		"AI Agents": [],
 		TanStack: []
 	};
@@ -1365,6 +1368,7 @@ async function getAddonsToAdd(frontend, existingAddons = [], auth) {
 		if (ADDON_GROUPS.Tooling.includes(addon)) groupedOptions.Tooling.push(option);
 		else if (ADDON_GROUPS.Documentation.includes(addon)) groupedOptions.Documentation.push(option);
 		else if (ADDON_GROUPS.Extensions.includes(addon)) groupedOptions.Extensions.push(option);
+		else if (ADDON_GROUPS.Integrations.includes(addon)) groupedOptions.Integrations.push(option);
 		else if (ADDON_GROUPS["AI Agents"].includes(addon)) groupedOptions["AI Agents"].push(option);
 		else if (ADDON_GROUPS.TanStack.includes(addon)) groupedOptions.TanStack.push(option);
 	}
@@ -1413,6 +1417,7 @@ async function writeBtsConfig(projectConfig) {
 		forms: projectConfig.forms,
 		testing: projectConfig.testing,
 		packageManager: projectConfig.packageManager,
+		versionChannel: projectConfig.versionChannel,
 		dbSetup: projectConfig.dbSetup,
 		api: projectConfig.api,
 		webDeploy: projectConfig.webDeploy,
@@ -1472,6 +1477,7 @@ async function writeBtsConfig(projectConfig) {
 		forms: btsConfig.forms,
 		testing: btsConfig.testing,
 		packageManager: btsConfig.packageManager,
+		versionChannel: btsConfig.versionChannel,
 		dbSetup: btsConfig.dbSetup,
 		api: btsConfig.api,
 		webDeploy: btsConfig.webDeploy,
@@ -1558,6 +1564,166 @@ async function updateBtsConfig(projectDir, updates) {
 	} catch {}
 }
 
+//#endregion
+//#region src/utils/dependency-version-channel.ts
+const VERSION_CACHE = /* @__PURE__ */ new Map();
+const PRERELEASE_TAG_PRIORITY = [
+	"beta",
+	"next",
+	"rc",
+	"canary",
+	"alpha"
+];
+const REGISTRY_FETCH_TIMEOUT_MS = 1e4;
+const REGISTRY_CONCURRENCY = 10;
+function mapWithConcurrency(items, fn, concurrency) {
+	const results = Array.from({ length: items.length });
+	let index = 0;
+	async function worker() {
+		while (index < items.length) {
+			const i = index++;
+			results[i] = await fn(items[i], i);
+		}
+	}
+	return Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => worker())).then(() => results);
+}
+function parseVersion(value) {
+	const normalized = value.replace(/^[^\d]*/, "");
+	const dashIdx = normalized.indexOf("-");
+	const base = dashIdx === -1 ? normalized : normalized.slice(0, dashIdx);
+	const prerelease = dashIdx === -1 ? "" : normalized.slice(dashIdx + 1);
+	const [major = "0", minor = "0", patch = "0"] = base.split(".");
+	return {
+		major: Number(major) || 0,
+		minor: Number(minor) || 0,
+		patch: Number(patch) || 0,
+		prerelease: prerelease ? prerelease.split(/[.-]/).map((part) => /^\d+$/.test(part) ? Number(part) : part) : []
+	};
+}
+function compareVersions(a, b) {
+	const left = parseVersion(a);
+	const right = parseVersion(b);
+	if (left.major !== right.major) return left.major - right.major;
+	if (left.minor !== right.minor) return left.minor - right.minor;
+	if (left.patch !== right.patch) return left.patch - right.patch;
+	if (left.prerelease.length === 0 && right.prerelease.length === 0) return 0;
+	if (left.prerelease.length === 0) return 1;
+	if (right.prerelease.length === 0) return -1;
+	const maxLength = Math.max(left.prerelease.length, right.prerelease.length);
+	for (let index = 0; index < maxLength; index++) {
+		const leftPart = left.prerelease[index];
+		const rightPart = right.prerelease[index];
+		if (leftPart === void 0) return -1;
+		if (rightPart === void 0) return 1;
+		if (leftPart === rightPart) continue;
+		if (typeof leftPart === "number" && typeof rightPart === "number") return leftPart - rightPart;
+		if (typeof leftPart === "number") return -1;
+		if (typeof rightPart === "number") return 1;
+		return leftPart.localeCompare(rightPart);
+	}
+	return 0;
+}
+function isPrerelease(version) {
+	return /-(alpha|beta|rc|next|canary)/i.test(version);
+}
+function getVersionPrefix(version) {
+	return version.match(/^[^\d]*/)?.[0] ?? "";
+}
+function applyVersionPrefix(currentVersion, resolvedVersion) {
+	return `${getVersionPrefix(currentVersion)}${resolvedVersion}`;
+}
+function isRegistrySemverSpec(version) {
+	return /^[~^]?\d/.test(version);
+}
+async function fetchPackageInfo(packageName) {
+	const cached = VERSION_CACHE.get(packageName);
+	if (cached) return cached;
+	const encodedName = encodeURIComponent(packageName).replace("%40", "@");
+	const response = await fetch(`https://registry.npmjs.org/${encodedName}`, {
+		headers: { Accept: "application/vnd.npm.install-v1+json" },
+		signal: AbortSignal.timeout(REGISTRY_FETCH_TIMEOUT_MS)
+	});
+	if (!response.ok) throw new Error(`Package ${packageName} not found (${response.status})`);
+	const raw = await response.json();
+	const data = {
+		"dist-tags": raw["dist-tags"],
+		versions: raw["versions"]
+	};
+	VERSION_CACHE.set(packageName, data);
+	return data;
+}
+function selectRegistryVersionForChannel(packageInfo, channel) {
+	const tags = packageInfo["dist-tags"] ?? {};
+	if (channel === "latest") return tags.latest ?? null;
+	for (const tag of PRERELEASE_TAG_PRIORITY) if (tags[tag]) return tags[tag];
+	const prereleases = Object.keys(packageInfo.versions ?? {}).filter(isPrerelease);
+	if (prereleases.length > 0) return prereleases.sort((left, right) => compareVersions(right, left))[0] ?? null;
+	return tags.latest ?? null;
+}
+async function resolveRegistryVersion(packageName, channel) {
+	const version = selectRegistryVersionForChannel(await fetchPackageInfo(packageName), channel);
+	if (!version) throw new Error(`No ${channel} version available for ${packageName}`);
+	return version;
+}
+async function collectPackageJsonPaths$1(projectDir) {
+	const results = [];
+	async function walk(currentDir) {
+		const entries = await fs.readdir(currentDir, { withFileTypes: true });
+		for (const entry of entries) {
+			if (entry.name === "node_modules" || entry.name === ".git" || entry.name === ".turbo") continue;
+			const fullPath = path.join(currentDir, entry.name);
+			if (entry.isDirectory()) {
+				await walk(fullPath);
+				continue;
+			}
+			if (entry.isFile() && entry.name === "package.json") results.push(fullPath);
+		}
+	}
+	await walk(projectDir);
+	return results.sort();
+}
+async function applyDependencyVersionChannel(projectDir, channel) {
+	if (channel === "stable") return;
+	const packageJsonPaths = await collectPackageJsonPaths$1(projectDir);
+	if (packageJsonPaths.length === 0) return;
+	const packageNames = /* @__PURE__ */ new Set();
+	for (const packageJsonPath of packageJsonPaths) {
+		const packageJson = await fs.readJson(packageJsonPath);
+		for (const [depName, depVersion] of Object.entries(packageJson.dependencies ?? {})) if (typeof depVersion === "string" && isRegistrySemverSpec(depVersion)) packageNames.add(depName);
+		for (const [depName, depVersion] of Object.entries(packageJson.devDependencies ?? {})) if (typeof depVersion === "string" && isRegistrySemverSpec(depVersion)) packageNames.add(depName);
+	}
+	if (packageNames.size === 0) return;
+	const resolvedVersions = /* @__PURE__ */ new Map();
+	await mapWithConcurrency([...packageNames], async (packageName) => {
+		try {
+			const resolvedVersion = await resolveRegistryVersion(packageName, channel);
+			resolvedVersions.set(packageName, resolvedVersion);
+		} catch (error) {
+			log.warn(`Failed to resolve ${channel} version for ${packageName}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}, REGISTRY_CONCURRENCY);
+	if (resolvedVersions.size === 0) return;
+	for (const packageJsonPath of packageJsonPaths) {
+		const packageJson = await fs.readJson(packageJsonPath);
+		let changed = false;
+		for (const sectionName of ["dependencies", "devDependencies"]) {
+			const section = packageJson[sectionName];
+			if (!section) continue;
+			for (const [packageName, currentVersion] of Object.entries(section)) {
+				if (!isRegistrySemverSpec(currentVersion)) continue;
+				const resolvedVersion = resolvedVersions.get(packageName);
+				if (!resolvedVersion) continue;
+				const nextVersion = applyVersionPrefix(currentVersion, resolvedVersion);
+				if (nextVersion !== currentVersion) {
+					section[packageName] = nextVersion;
+					changed = true;
+				}
+			}
+		}
+		if (changed) await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+	}
+}
+
 //#endregion
 //#region src/utils/add-package-deps.ts
 const addPackageDependency = async (opts) => {
@@ -2946,6 +3112,7 @@ async function addHandlerInternal(input) {
 		config
 	}, projectDir);
 	await setupAddons(config);
+	await applyDependencyVersionChannel(projectDir, config.versionChannel);
 	const configUpdates = { addons: [...new Set([...existingAddons, ...addonsToAdd])] };
 	if (input.webDeploy !== void 0) configUpdates.webDeploy = input.webDeploy;
 	if (input.serverDeploy !== void 0) configUpdates.serverDeploy = input.serverDeploy;
@@ -5039,6 +5206,12 @@ const ICON_LIBRARY_OPTIONS = [
 	}
 ];
 const COLOR_THEME_OPTIONS = [
+	{
+		value: "neutral",
+		label: "── Neutrals ──",
+		hint: "",
+		disabled: true
+	},
 	{
 		value: "neutral",
 		label: "Neutral",
@@ -5059,20 +5232,52 @@ const COLOR_THEME_OPTIONS = [
 		label: "Gray",
 		hint: "Blue-tinted neutral"
 	},
+	{
+		value: "neutral",
+		label: "── Cool ──",
+		hint: "",
+		disabled: true
+	},
 	{
 		value: "blue",
 		label: "Blue",
 		hint: "Trust and reliability"
 	},
+	{
+		value: "indigo",
+		label: "Indigo",
+		hint: "Deep and focused"
+	},
 	{
 		value: "violet",
 		label: "Violet",
 		hint: "Creative and modern"
 	},
 	{
-		value: "green",
-		label: "Green",
-		hint: "Growth and success"
+		value: "purple",
+		label: "Purple",
+		hint: "Royal and elegant"
+	},
+	{
+		value: "cyan",
+		label: "Cyan",
+		hint: "Cool and refreshing"
+	},
+	{
+		value: "sky",
+		label: "Sky",
+		hint: "Light and airy"
+	},
+	{
+		value: "teal",
+		label: "Teal",
+		hint: "Calm and sophisticated"
+	},
+	{
+		value: "neutral",
+		label: "── Warm ──",
+		hint: "",
+		disabled: true
 	},
 	{
 		value: "red",
@@ -5104,36 +5309,16 @@ const COLOR_THEME_OPTIONS = [
 		label: "Lime",
 		hint: "Fresh and lively"
 	},
+	{
+		value: "green",
+		label: "Green",
+		hint: "Growth and success"
+	},
 	{
 		value: "emerald",
 		label: "Emerald",
 		hint: "Rich and luxurious"
 	},
-	{
-		value: "teal",
-		label: "Teal",
-		hint: "Calm and sophisticated"
-	},
-	{
-		value: "cyan",
-		label: "Cyan",
-		hint: "Cool and refreshing"
-	},
-	{
-		value: "sky",
-		label: "Sky",
-		hint: "Light and airy"
-	},
-	{
-		value: "indigo",
-		label: "Indigo",
-		hint: "Deep and focused"
-	},
-	{
-		value: "purple",
-		label: "Purple",
-		hint: "Royal and elegant"
-	},
 	{
 		value: "fuchsia",
 		label: "Fuchsia",
@@ -5985,6 +6170,35 @@ async function getProjectName(initialName) {
 	return projectPath;
 }
 
+//#endregion
+//#region src/prompts/version-channel.ts
+async function getVersionChannelChoice(versionChannel) {
+	if (versionChannel !== void 0) return versionChannel;
+	const response = await navigableSelect({
+		message: "Choose dependency version channel",
+		options: [
+			{
+				value: "stable",
+				label: "Stable",
+				hint: "Use Better Fullstack's curated pinned versions"
+			},
+			{
+				value: "latest",
+				label: "Latest",
+				hint: "Resolve current npm latest tags during scaffolding"
+			},
+			{
+				value: "beta",
+				label: "Beta",
+				hint: "Prefer npm beta/next prerelease tags when available"
+			}
+		],
+		initialValue: "stable"
+	});
+	if (isCancel$1(response)) return exitCancelled("Operation cancelled");
+	return response;
+}
+
 //#endregion
 //#region src/utils/telemetry.ts
 /**
@@ -6077,6 +6291,7 @@ function displayConfig(config) {
 		configDisplay.push(`${pc.blue("Git Init:")} ${gitText}`);
 	}
 	if (config.packageManager !== void 0) configDisplay.push(`${pc.blue("Package Manager:")} ${String(config.packageManager)}`);
+	if (config.versionChannel !== void 0) configDisplay.push(`${pc.blue("Version Channel:")} ${String(config.versionChannel)}`);
 	if (config.install !== void 0) {
 		const installText = typeof config.install === "boolean" ? config.install ? "Yes" : "No" : String(config.install);
 		configDisplay.push(`${pc.blue("Install Dependencies:")} ${installText}`);
@@ -6109,6 +6324,7 @@ function appendCommonFlags(flags, config) {
 	else flags.push("--ai-docs none");
 	flags.push(config.git ? "--git" : "--no-git");
 	flags.push(`--package-manager ${config.packageManager}`);
+	if (config.versionChannel !== "stable") flags.push(`--version-channel ${config.versionChannel}`);
 	flags.push(config.install ? "--install" : "--no-install");
 }
 function appendSharedNonTypeScriptFlags(flags, config) {
@@ -6432,6 +6648,7 @@ function processFlags(options, projectName) {
 	if (options.runtime) config.runtime = options.runtime;
 	if (options.dbSetup) config.dbSetup = options.dbSetup;
 	if (options.packageManager) config.packageManager = options.packageManager;
+	if (options.versionChannel) config.versionChannel = options.versionChannel;
 	if (options.webDeploy) config.webDeploy = options.webDeploy;
 	if (options.serverDeploy) config.serverDeploy = options.serverDeploy;
 	const derivedName = deriveProjectName(projectName, options.projectDirectory);
@@ -6789,6 +7006,15 @@ function validateDatabaseSetup(config, providedFlags) {
 function validateEcosystemAuthCompatibility(config, providedFlags) {
 	const auth = config.auth;
 	if (!auth || auth === "none") return;
+	if (auth === "better-auth" && config.orm && [
+		"typeorm",
+		"sequelize",
+		"mikroorm"
+	].includes(config.orm)) {
+		config.auth = "none";
+		if (providedFlags?.has("auth") && !isSilent()) consola.warn(pc.yellow(`Unsupported auth selection '${auth}' with ${config.orm}: no Better Auth adapter exists. Falling back to '--auth none'.`));
+		return;
+	}
 	const normalized = (0, types_exports.normalizeCapabilitySelection)("auth", {
 		ecosystem: config.ecosystem,
 		backend: config.backend,
@@ -8321,7 +8547,7 @@ async function displayPostInstallInstructions(config) {
 	let output = `${pc.bold("Next steps")}\n${pc.cyan("1.")} ${cdCmd}\n`;
 	let stepCounter = 2;
 	if (!depsInstalled) output += `${pc.cyan(`${stepCounter++}.`)} ${packageManager} install\n`;
-	if (hasFresh) output += `${pc.yellow("NOTE:")} Fresh projects require ${pc.white("deno")} on your PATH\n`;
+	if (hasFresh) output += `${pc.yellow("NOTE:")} Fresh projects require ${pc.white("deno")} on your PATH.\n   Install: ${pc.underline("https://docs.deno.com/runtime/getting_started/installation/")}\n`;
 	if (database === "sqlite" && dbSetup !== "d1") output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} db:local\n${pc.dim("   (optional - starts local SQLite database)")}\n`;
 	if (isConvex) {
 		output += `${pc.cyan(`${stepCounter++}.`)} ${runCmd} dev:setup\n${pc.dim("   (this will guide you through Convex project setup)")}\n`;
@@ -8409,7 +8635,7 @@ async function getDatabaseInstructions(database, orm, runCmd, _runtime, dbSetup,
 	}
 	if (dbSetup === "turso" && orm === "prisma") instructions.push(`${pc.yellow("NOTE:")} Follow Turso's Prisma guide for migrations via the Turso CLI:\n   https://docs.turso.tech/sdk/ts/orm/prisma`);
 	if (orm === "prisma") {
-		if (database === "mongodb" && dbSetup === "docker") instructions.push(`${pc.yellow("WARNING:")} Prisma + MongoDB + Docker combination\n   may not work.`);
+		if (database === "mongodb" && dbSetup === "docker") instructions.push(`${pc.yellow("WARNING:")} Prisma + MongoDB + Docker: this combination has known issues.\n   Consider using MongoDB Atlas (${pc.underline("https://www.mongodb.com/atlas")}) for reliable Prisma + MongoDB support.`);
 		if (dbSetup === "docker") instructions.push(`${pc.cyan("•")} Start docker container: ${`${runCmd} db:start`}`);
 		if (!(dbSetup === "d1" && serverDeploy === "cloudflare")) {
 			instructions.push(`${pc.cyan("•")} Generate Prisma Client: ${`${runCmd} db:generate`}`);
@@ -8607,6 +8833,7 @@ async function createProject(options, cliInput = {}) {
 		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 applyDependencyVersionChannel(projectDir, options.versionChannel);
 		await writeBtsConfig(options);
 		await formatProject(projectDir);
 		if (!isSilent()) log.success("Project template successfully scaffolded!");
@@ -8651,6 +8878,10 @@ async function setPackageManagerVersion(projectDir, packageManager) {
 
 //#endregion
 //#region src/helpers/core/command-handlers.ts
+function shouldPromptForVersionChannel(input) {
+	if (input.yes || input.versionChannel !== void 0 || isSilent()) return false;
+	return process.stdin.isTTY === true && process.stdout.isTTY === true && process.env.CI !== "true";
+}
 async function createProjectHandler(input, options = {}) {
 	const { silent = false } = options;
 	return runWithContextAsync({ silent }, async () => {
@@ -8672,6 +8903,7 @@ async function createProjectHandler(input, options = {}) {
 				}
 				currentPathInput = defaultName;
 			} else currentPathInput = await getProjectName(input.projectName);
+			const versionChannel = shouldPromptForVersionChannel(input) ? await getVersionChannelChoice() : input.versionChannel ?? "stable";
 			let finalPathInput;
 			let shouldClearDirectory;
 			try {
@@ -8707,6 +8939,7 @@ async function createProjectHandler(input, options = {}) {
 						effect: "none",
 						git: false,
 						packageManager: "npm",
+						versionChannel: "stable",
 						install: false,
 						dbSetup: "none",
 						api: "none",
@@ -8791,7 +9024,8 @@ async function createProjectHandler(input, options = {}) {
 					...flagConfig,
 					projectName: finalBaseName,
 					projectDir: finalResolvedPath,
-					relativePath: finalPathInput
+					relativePath: finalPathInput,
+					versionChannel
 				};
 				validateConfigCompatibility(config, providedFlags, cliInput);
 				const yesPreflight = validatePreflightConfig(config);
@@ -8808,7 +9042,10 @@ async function createProjectHandler(input, options = {}) {
 					log.message(displayConfig(otherFlags));
 					log.message("");
 				}
-				config = await gatherConfig(flagConfig, finalBaseName, finalResolvedPath, finalPathInput);
+				config = {
+					...await gatherConfig(flagConfig, finalBaseName, finalResolvedPath, finalPathInput),
+					versionChannel
+				};
 			}
 			const preflight = validatePreflightConfig(config);
 			if (preflight.hasWarnings && !isSilent()) displayPreflightWarnings(preflight);
@@ -9002,6 +9239,7 @@ const router = os.router({
 		git: z.boolean().optional(),
 		packageManager: types_exports.PackageManagerSchema.optional(),
 		install: z.boolean().optional(),
+		versionChannel: types_exports.VersionChannelSchema.optional().describe("Dependency version channel (stable, latest, beta)"),
 		dbSetup: types_exports.DatabaseSetupSchema.optional(),
 		backend: types_exports.BackendSchema.optional(),
 		runtime: types_exports.RuntimeSchema.optional(),
@@ -9065,7 +9303,7 @@ const router = os.router({
 			log.message(`Please visit ${DOCS_URL}`);
 		}
 	}),
-	builder: os.meta({ description: "Open the web-based stack builder" }).handler(async () => {
+	builder: os.meta({ description: "Open the interactive web-based stack builder at better-fullstack.dev" }).handler(async () => {
 		const BUILDER_URL = "https://better-fullstack-web.vercel.app/new";
 		try {
 			await openUrl(BUILDER_URL);
@@ -9074,7 +9312,7 @@ const router = os.router({
 			log.message(`Please visit ${BUILDER_URL}`);
 		}
 	}),
-	add: os.meta({ description: "Add addons to an existing Better Fullstack project" }).input(z.object({
+	add: os.meta({ description: "Add addons or deployment targets to an existing Better Fullstack project" }).input(z.object({
 		addons: z.array(types_exports.AddonsSchema).optional().describe("Addons to add"),
 		webDeploy: types_exports.WebDeploySchema.optional().describe("Web deployment option to set"),
 		serverDeploy: types_exports.ServerDeploySchema.optional().describe("Server deployment option to set"),
@@ -9084,7 +9322,7 @@ const router = os.router({
 	})).handler(async ({ input }) => {
 		await addHandler(input);
 	}),
-	history: os.meta({ description: "Show project creation history" }).input(z.object({
+	history: os.meta({ description: "Show history of scaffolded projects with reproducible commands" }).input(z.object({
 		limit: z.number().optional().default(10).describe("Number of entries to show"),
 		clear: z.boolean().optional().default(false).describe("Clear all history"),
 		json: z.boolean().optional().default(false).describe("Output as JSON")
@@ -9226,6 +9464,7 @@ async function createVirtual(options) {
 				effect: options.effect || "none",
 				git: options.git ?? false,
 				packageManager: options.packageManager || "bun",
+				versionChannel: options.versionChannel || "stable",
 				install: false,
 				dbSetup: options.dbSetup || "none",
 				api: options.api || "trpc",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-fullstack",
-  "version": "1.4.16",
+  "version": "1.5.1",
   "description": "Scaffold production-ready fullstack apps in seconds. Pick your stack from 270+ options — the CLI wires everything together.",
   "keywords": [
     "angular",
@@ -108,17 +108,17 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-fullstack/template-generator": "^1.4.16",
-    "@better-fullstack/types": "^1.4.16",
+    "@better-fullstack/template-generator": "^1.5.1",
+    "@better-fullstack/types": "^1.5.1",
     "@clack/core": "^0.5.0",
     "@clack/prompts": "^1.1.0",
-    "@orpc/server": "^1.13.9",
+    "@orpc/server": "^1.13.13",
     "consola": "^3.4.2",
     "env-paths": "^4.0.0",
     "execa": "^9.6.1",
     "fs-extra": "^11.3.4",
     "gradient-string": "^3.0.0",
-    "handlebars": "^4.7.8",
+    "handlebars": "^4.7.9",
     "jsonc-parser": "^3.3.1",
     "oxfmt": "^0.19.0",
     "picocolors": "^1.1.1",