create-better-fullstack 1.4.16 → 1.5.0

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-DaUU4ThO.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-DaUU4ThO.mjs";
 
 export { EMBEDDED_TEMPLATES, TEMPLATE_COUNT, VirtualFileSystem, add, builder, create, createBtsCli, createVirtual, docs, generateVirtualProject, history, router, sponsors };

package/dist/{src-BVbxA2WC.mjs → src-DaUU4ThO.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;
@@ -5985,6 +6152,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 +6273,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 +6306,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 +6630,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);
@@ -8607,6 +8806,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 +8851,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 +8876,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 +8912,7 @@ async function createProjectHandler(input, options = {}) {
 						effect: "none",
 						git: false,
 						packageManager: "npm",
+						versionChannel: "stable",
 						install: false,
 						dbSetup: "none",
 						api: "none",
@@ -8791,7 +8997,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 +9015,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 +9212,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(),
@@ -9226,6 +9437,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.0",
   "description": "Scaffold production-ready fullstack apps in seconds. Pick your stack from 270+ options — the CLI wires everything together.",
   "keywords": [
     "angular",
@@ -108,8 +108,8 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@better-fullstack/template-generator": "^1.4.16",
-    "@better-fullstack/types": "^1.4.16",
+    "@better-fullstack/template-generator": "^1.5.0",
+    "@better-fullstack/types": "^1.5.0",
     "@clack/core": "^0.5.0",
     "@clack/prompts": "^1.1.0",
     "@orpc/server": "^1.13.9",