add workers support for tanstack start (#369)

.changeset/upset-pears-argue.md

@@ -0,0 +1,5 @@
+---
+"create-better-t-stack": minor
+---
+
+add workers support for tanstack start

apps/cli/src/helpers/project-generation/add-deployment.ts

@@ -42,24 +42,6 @@ export async function addDeploymentToProject(
 			);
 		}
 
-		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: ProjectConfig = {
 			projectName: detectedConfig.projectName || path.basename(projectDir),
 			projectDir,

apps/cli/src/helpers/project-generation/template-manager.ts

@@ -851,6 +851,7 @@ export async function setupDeploymentTemplates(
 
 		const templateMap: Record<string, string> = {
 			"tanstack-router": "react/tanstack-router",
+			"tanstack-start": "react/tanstack-start",
 			"react-router": "react/react-router",
 			solid: "solid",
 			next: "react/next",

apps/cli/src/helpers/setup/web-deploy-setup.ts

@@ -4,6 +4,7 @@ import type { PackageManager, ProjectConfig } from "../../types";
 import { addPackageDependency } from "../../utils/add-package-deps";
 import { setupNuxtWorkersDeploy } from "./workers-nuxt-setup";
 import { setupSvelteWorkersDeploy } from "./workers-svelte-setup";
+import { setupTanstackStartWorkersDeploy } from "./workers-tanstack-start-setup";
 import { setupWorkersVitePlugin } from "./workers-vite-setup";
 
 export async function setupWebDeploy(config: ProjectConfig): Promise<void> {
@@ -18,6 +19,7 @@ export async function setupWebDeploy(config: ProjectConfig): Promise<void> {
 	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");
 
@@ -27,6 +29,8 @@ export async function setupWebDeploy(config: ProjectConfig): Promise<void> {
 		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);
 	}

apps/cli/src/helpers/setup/workers-tanstack-start-setup.ts

@@ -0,0 +1,75 @@
+import path from "node:path";
+import fs from "fs-extra";
+import {
+	type CallExpression,
+	Node,
+	type ObjectLiteralExpression,
+	SyntaxKind,
+} from "ts-morph";
+import type { PackageManager } from "../../types";
+import { addPackageDependency } from "../../utils/add-package-deps";
+import { ensureArrayProperty, tsProject } from "../../utils/ts-morph";
+
+export async function setupTanstackStartWorkersDeploy(
+	projectDir: string,
+	packageManager: PackageManager,
+): Promise<void> {
+	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"
+			);
+		}) as CallExpression | undefined;
+
+	if (!defineCall) return;
+
+	const configObj = defineCall.getArguments()[0] as
+		| ObjectLiteralExpression
+		| undefined;
+	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();
+}

apps/cli/src/prompts/web-deploy.ts

@@ -3,15 +3,6 @@ import pc from "picocolors";
 import { DEFAULT_CONFIG } from "../constants";
 import type { Backend, Frontend, Runtime, WebDeploy } from "../types";
 
-const WORKERS_COMPATIBLE_FRONTENDS: Frontend[] = [
-	"tanstack-router",
-	"react-router",
-	"solid",
-	"next",
-	"nuxt",
-	"svelte",
-];
-
 type DeploymentOption = {
 	value: WebDeploy;
 	label: string;
@@ -38,18 +29,10 @@ export async function getDeploymentChoice(
 	deployment?: WebDeploy,
 	_runtime?: Runtime,
 	_backend?: Backend,
-	frontend: Frontend[] = [],
+	_frontend: Frontend[] = [],
 ): Promise<WebDeploy> {
 	if (deployment !== undefined) return deployment;
 
-	const hasCompatibleFrontend = frontend.some((f) =>
-		WORKERS_COMPATIBLE_FRONTENDS.includes(f),
-	);
-
-	if (!hasCompatibleFrontend) {
-		return "none";
-	}
-
 	const options: DeploymentOption[] = [
 		{
 			value: "workers",
@@ -74,15 +57,12 @@ export async function getDeploymentChoice(
 }
 
 export async function getDeploymentToAdd(
-	frontend: Frontend[],
+	_frontend: Frontend[],
 	existingDeployment?: WebDeploy,
 ): Promise<WebDeploy> {
 	const options: DeploymentOption[] = [];
 
-	if (
+	if (existingDeployment !== "workers") {
-		frontend.some((f) => WORKERS_COMPATIBLE_FRONTENDS.includes(f)) &&
-		existingDeployment !== "workers"
-	) {
 		const { label, hint } = getDeploymentDisplay("workers");
 		options.push({
 			value: "workers",

apps/cli/src/validation.ts

@@ -451,24 +451,6 @@ export function processAndValidateFlags(
 		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.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;
 }
 

apps/cli/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>",
+    //   },
+    // ],
+  }
+  

apps/cli/templates/frontend/react/web-base/_gitignore

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

apps/web/public/schema.json

@@ -21,23 +21,12 @@
 		},
 		"database": {
 			"type": "string",
-      "enum": [
+			"enum": ["none", "sqlite", "postgres", "mysql", "mongodb"],
-        "none",
-        "sqlite",
-        "postgres",
-        "mysql",
-        "mongodb"
-      ],
 			"description": "Database type"
 		},
 		"orm": {
 			"type": "string",
-      "enum": [
+			"enum": ["drizzle", "prisma", "mongoose", "none"],
-        "drizzle",
-        "prisma",
-        "mongoose",
-        "none"
-      ],
 			"description": "ORM type"
 		},
 		"backend": {
@@ -55,12 +44,7 @@
 		},
 		"runtime": {
 			"type": "string",
-      "enum": [
+			"enum": ["bun", "node", "workers", "none"],
-        "bun",
-        "node",
-        "workers",
-        "none"
-      ],
 			"description": "Runtime environment (workers only available with hono backend and drizzle orm)"
 		},
 		"frontend": {
@@ -102,11 +86,7 @@
 			"type": "array",
 			"items": {
 				"type": "string",
-        "enum": [
+				"enum": ["todo", "ai", "none"]
-          "todo",
-          "ai",
-          "none"
-        ]
 			},
 			"description": "Example templates to include"
 		},
@@ -116,11 +96,7 @@
 		},
 		"packageManager": {
 			"type": "string",
-      "enum": [
+			"enum": ["npm", "pnpm", "bun"],
-        "npm",
-        "pnpm",
-        "bun"
-      ],
 			"description": "Package manager"
 		},
 		"dbSetup": {
@@ -138,19 +114,12 @@
 		},
 		"api": {
 			"type": "string",
-      "enum": [
+			"enum": ["trpc", "orpc", "none"],
-        "trpc",
-        "orpc",
-        "none"
-      ],
 			"description": "API type"
 		},
 		"webDeploy": {
 			"type": "string",
-      "enum": [
+			"enum": ["workers", "none"],
-        "workers",
-        "none"
-      ],
 			"description": "Web deployment"
 		}
 	},

apps/web/src/app/(home)/_components/stack-builder.tsx

@@ -802,28 +802,6 @@ const analyzeStackCompatibility = (stack: StackState): CompatibilityResult => {
 				if (nextStack.examples.length !== originalExamplesLength)
 					changed = true;
 			}
-
-			// Web deploy compatibility: Workers not supported with TanStack Start
-			if (
-				nextStack.webDeploy === "workers" &&
-				nextStack.webFrontend.includes("tanstack-start")
-			) {
-				notes.webDeploy.notes.push(
-					"Cloudflare Workers deployment is not supported with TanStack Start. It will be set to 'None'.",
-				);
-				notes.webFrontend.notes.push(
-					"TanStack Start is not compatible with Cloudflare Workers deployment.",
-				);
-				notes.webDeploy.hasIssue = true;
-				notes.webFrontend.hasIssue = true;
-				nextStack.webDeploy = "none";
-				changed = true;
-				changes.push({
-					category: "webDeploy",
-					message:
-						"Web deployment set to 'None' (Workers not compatible with TanStack Start)",
-				});
-			}
 		}
 	}