create-better-t-stack 2.23.0 → 2.24.0

package/dist/index.js

@@ -834,14 +834,6 @@ async function getRuntimeChoice(runtime, backend) {
 
 //#endregion
 //#region src/prompts/web-deploy.ts
-const WORKERS_COMPATIBLE_FRONTENDS = [
-	"tanstack-router",
-	"react-router",
-	"solid",
-	"next",
-	"nuxt",
-	"svelte"
-];
 function getDeploymentDisplay(deployment) {
 	if (deployment === "workers") return {
 		label: "Cloudflare Workers",
@@ -852,10 +844,8 @@ function getDeploymentDisplay(deployment) {
 		hint: `Add ${deployment} deployment`
 	};
 }
-async function getDeploymentChoice(deployment, _runtime, _backend, frontend = []) {
+async function getDeploymentChoice(deployment, _runtime, _backend, _frontend = []) {
 	if (deployment !== void 0) return deployment;
-	const hasCompatibleFrontend = frontend.some((f) => WORKERS_COMPATIBLE_FRONTENDS.includes(f));
-	if (!hasCompatibleFrontend) return "none";
 	const options = [{
 		value: "workers",
 		label: "Cloudflare Workers",
@@ -876,9 +866,9 @@ async function getDeploymentChoice(deployment, _runtime, _backend, frontend = []
 	}
 	return response;
 }
-async function getDeploymentToAdd(frontend, existingDeployment) {
+async function getDeploymentToAdd(_frontend, existingDeployment) {
 	const options = [];
-	if (frontend.some((f) => WORKERS_COMPATIBLE_FRONTENDS.includes(f)) && existingDeployment !== "workers") {
+	if (existingDeployment !== "workers") {
 		const { label, hint } = getDeploymentDisplay("workers");
 		options.push({
 			value: "workers",
@@ -1483,13 +1473,6 @@ function processAndValidateFlags(options, providedFlags, projectName) {
 		consola$1.fatal("MongoDB database is not compatible with Cloudflare Workers runtime. MongoDB requires Prisma or Mongoose ORM, but Workers runtime only supports Drizzle ORM. Please use a different database or runtime.");
 		process.exit(1);
 	}
-	if (config.webDeploy === "workers" && config.frontend && config.frontend.length > 0) {
-		const incompatibleFrontends = config.frontend.filter((f) => f === "tanstack-start");
-		if (incompatibleFrontends.length > 0) {
-			consola$1.fatal(`The following frontends are not compatible with '--web-deploy workers': ${incompatibleFrontends.join(", ")}. Please choose a different frontend or remove '--web-deploy workers'.`);
-			process.exit(1);
-		}
-	}
 	return config;
 }
 function getProvidedFlags(options) {
@@ -2283,6 +2266,7 @@ async function setupDeploymentTemplates(projectDir, context) {
 		const frontends = context.frontend;
 		const templateMap = {
 			"tanstack-router": "react/tanstack-router",
+			"tanstack-start": "react/tanstack-start",
 			"react-router": "react/react-router",
 			solid: "solid",
 			next: "react/next",
@@ -2450,6 +2434,44 @@ async function setupSvelteWorkersDeploy(projectDir, packageManager) {
 	}
 }
 
+//#endregion
+//#region src/helpers/setup/workers-tanstack-start-setup.ts
+async function setupTanstackStartWorkersDeploy(projectDir, packageManager) {
+	const webAppDir = path.join(projectDir, "apps/web");
+	if (!await fs.pathExists(webAppDir)) return;
+	await addPackageDependency({
+		devDependencies: ["wrangler"],
+		projectDir: webAppDir
+	});
+	const pkgPath = path.join(webAppDir, "package.json");
+	if (await fs.pathExists(pkgPath)) {
+		const pkg = await fs.readJson(pkgPath);
+		pkg.scripts = {
+			...pkg.scripts,
+			deploy: `${packageManager} run build && wrangler deploy`,
+			"cf-typegen": "wrangler types --env-interface Env"
+		};
+		await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+	}
+	const viteConfigPath = path.join(webAppDir, "vite.config.ts");
+	if (!await fs.pathExists(viteConfigPath)) return;
+	const sourceFile = tsProject.addSourceFileAtPathIfExists(viteConfigPath);
+	if (!sourceFile) return;
+	const defineCall = sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression).find((expr) => {
+		const expression = expr.getExpression();
+		return Node.isIdentifier(expression) && expression.getText() === "defineConfig";
+	});
+	if (!defineCall) return;
+	const configObj = defineCall.getArguments()[0];
+	if (!configObj) return;
+	const pluginsArray = ensureArrayProperty(configObj, "plugins");
+	const tanstackPluginIndex = pluginsArray.getElements().findIndex((el) => el.getText().includes("tanstackStart("));
+	const tanstackPluginText = "tanstackStart({ target: \"cloudflare-module\" })";
+	if (tanstackPluginIndex === -1) pluginsArray.addElement(tanstackPluginText);
+	else pluginsArray.getElements()[tanstackPluginIndex].replaceWithText(tanstackPluginText);
+	await tsProject.save();
+}
+
 //#endregion
 //#region src/helpers/setup/workers-vite-setup.ts
 async function setupWorkersVitePlugin(projectDir) {
@@ -2492,11 +2514,13 @@ async function setupWebDeploy(config) {
 	const isNuxt = frontend.includes("nuxt");
 	const isSvelte = frontend.includes("svelte");
 	const isTanstackRouter = frontend.includes("tanstack-router");
+	const isTanstackStart = frontend.includes("tanstack-start");
 	const isReactRouter = frontend.includes("react-router");
 	const isSolid = frontend.includes("solid");
 	if (isNext) await setupNextWorkersDeploy(projectDir, packageManager);
 	else if (isNuxt) await setupNuxtWorkersDeploy(projectDir, packageManager);
 	else if (isSvelte) await setupSvelteWorkersDeploy(projectDir, packageManager);
+	else if (isTanstackStart) await setupTanstackStartWorkersDeploy(projectDir, packageManager);
 	else if (isTanstackRouter || isReactRouter || isSolid) await setupWorkersWebDeploy(projectDir, packageManager);
 }
 async function setupWorkersWebDeploy(projectDir, pkgManager) {
@@ -2550,17 +2574,6 @@ async function addDeploymentToProject(input) {
 		const detectedConfig = await detectProjectConfig(projectDir);
 		if (!detectedConfig) exitWithError("Could not detect the project configuration. Please ensure this is a valid Better-T Stack project.");
 		if (detectedConfig.webDeploy === input.webDeploy) exitWithError(`${input.webDeploy} deployment is already configured for this project.`);
-		if (input.webDeploy === "workers") {
-			const compatibleFrontends = [
-				"tanstack-router",
-				"react-router",
-				"solid",
-				"next",
-				"svelte"
-			];
-			const hasCompatible = detectedConfig.frontend?.some((f) => compatibleFrontends.includes(f));
-			if (!hasCompatible) exitWithError("Cloudflare Workers deployment requires a compatible web frontend (tanstack-router, react-router, solid, next, or svelte).");
-		}
 		const config = {
 			projectName: detectedConfig.projectName || path.basename(projectDir),
 			projectDir,
@@ -4285,7 +4298,7 @@ async function initializeGit(projectDir, useGit) {
 //#endregion
 //#region src/helpers/project-generation/post-installation.ts
 function displayPostInstallInstructions(config) {
-	const { database, relativePath, packageManager, depsInstalled, orm, addons, runtime, frontend, backend, dbSetup } = config;
+	const { database, relativePath, packageManager, depsInstalled, orm, addons, runtime, frontend, backend, dbSetup, webDeploy } = config;
 	const isConvex = backend === "convex";
 	const runCmd = packageManager === "npm" ? "npm run" : packageManager;
 	const cdCmd = `cd ${relativePath}`;
@@ -4296,6 +4309,7 @@ function displayPostInstallInstructions(config) {
 	const nativeInstructions = frontend?.includes("native-nativewind") || frontend?.includes("native-unistyles") ? getNativeInstructions(isConvex) : "";
 	const pwaInstructions = addons?.includes("pwa") && frontend?.includes("react-router") ? getPwaInstructions() : "";
 	const starlightInstructions = addons?.includes("starlight") ? getStarlightInstructions(runCmd) : "";
+	const workersDeployInstructions = webDeploy === "workers" ? getWorkersDeployInstructions(runCmd) : "";
 	const hasWeb = frontend?.some((f) => [
 		"tanstack-router",
 		"react-router",
@@ -4337,6 +4351,7 @@ function displayPostInstallInstructions(config) {
 	if (tauriInstructions) output += `\n${tauriInstructions.trim()}\n`;
 	if (lintingInstructions) output += `\n${lintingInstructions.trim()}\n`;
 	if (pwaInstructions) output += `\n${pwaInstructions.trim()}\n`;
+	if (workersDeployInstructions) output += `\n${workersDeployInstructions.trim()}\n`;
 	if (starlightInstructions) output += `\n${starlightInstructions.trim()}\n`;
 	if (noOrmWarning) output += `\n${noOrmWarning.trim()}\n`;
 	if (bunWebNativeWarning) output += `\n${bunWebNativeWarning.trim()}\n`;
@@ -4396,6 +4411,9 @@ function getNoOrmWarning() {
 function getBunWebNativeWarning() {
 	return `\n${pc.yellow("WARNING:")} 'bun' might cause issues with web + native apps in a monorepo. Use 'pnpm' if problems arise.`;
 }
+function getWorkersDeployInstructions(runCmd) {
+	return `\n${pc.bold("Deploy frontend to Cloudflare Workers:")}\n${pc.cyan("•")} Deploy: ${`cd apps/web && ${runCmd || "bun run"} deploy`}`;
+}
 
 //#endregion
 //#region src/helpers/project-generation/project-config.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-better-t-stack",
-  "version": "2.23.0",
+  "version": "2.24.0",
   "description": "A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations",
   "type": "module",
   "license": "MIT",

package/templates/deploy/web/react/tanstack-start/wrangler.jsonc.hbs

@@ -0,0 +1,20 @@
+{
+    "$schema": "../../node_modules/wrangler/config-schema.json",
+    "name": "{{projectName}}",
+    "main": ".output/server/index.mjs",
+    "compatibility_date": "2025-07-05",
+    "compatibility_flags": ["nodejs_compat"],
+    "assets": {
+      "directory": ".output/public",
+    },
+    "observability": {
+      "enabled": true,
+    },
+    // "kv_namespaces": [
+    //   {
+    //     "binding": "CACHE",
+    //     "id": "<Your KV ID>",
+    //   },
+    // ],
+  }
+  

package/templates/frontend/react/web-base/_gitignore

@@ -19,6 +19,8 @@
 .vinxi
 .output
 .react-router/
+.tanstack/
+.nitro/
 
 # Deployment
 .vercel