Build TanStack Start apps with the Cloudflare Vite plugin

October 24, 2025

Build TanStack Start apps with the Cloudflare Vite plugin

The Cloudflare Vite plugin now supports TanStack Start ↗ apps. Get started with new or existing projects.

New projects

Create a new TanStack Start project that uses the Cloudflare Vite plugin via the create-cloudflare CLI:


								
									
									npm
									 create cloudflare@latest -- my-tanstack-start-app --framework=tanstack-start


								
									
									yarn
									 create cloudflare my-tanstack-start-app --framework=tanstack-start


								
									
									pnpm
									 create cloudflare@latest my-tanstack-start-app --framework=tanstack-start


								
									
									bun
									 create cloudflare@latest my-tanstack-start-app --framework=tanstack-start

Existing projects

Migrate an existing TanStack Start project to use the Cloudflare Vite plugin:

Install @cloudflare/vite-plugin and wrangler


								
									
									npm
									 i -D @cloudflare/vite-plugin wrangler


								
									
									yarn
									 add -D @cloudflare/vite-plugin wrangler


								
									
									pnpm
									 add -D @cloudflare/vite-plugin wrangler


								
									
									bun
									 add -d @cloudflare/vite-plugin wrangler

Add the Cloudflare plugin to your Vite config

vite.config.tsts

import { defineConfig } from "vite";
import { tanstackStart } from "@tanstack/react-start/plugin/vite";
import viteReact from "@vitejs/plugin-react";
import { cloudflare } from "@cloudflare/vite-plugin";

export default defineConfig({
	plugins: [
		cloudflare({ viteEnvironment: { name: "ssr" } }),
		tanstackStart(),
		viteReact(),
	],
});

Add your Worker config file

{
	"$schema": "./node_modules/wrangler/config-schema.json",
	"name": "my-tanstack-start-app",
	// Set this to today's date
	"compatibility_date": "2026-07-20",
	"compatibility_flags": [
		"nodejs_compat"
	],
	"main": "@tanstack/react-start/server-entry"
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "my-tanstack-start-app"
# Set this to today's date
compatibility_date = "2026-07-20"
compatibility_flags = [ "nodejs_compat" ]
main = "@tanstack/react-start/server-entry"

Modify the scripts in your package.json

package.jsonjson

{
	"scripts": {
		"dev": "vite dev",
		"build": "vite build && tsc --noEmit",
		"start": "node .output/server/index.mjs",
		"preview": "vite preview",
		"deploy": "npm run build && wrangler deploy",
		"cf-typegen": "wrangler types"
	}
}

See the TanStack Start framework guide for more info.