TanStack · elecmonkey · May 9, 2026 · May 9, 2026 · May 24, 2026 · May 25, 2026
diff --git a/.changeset/quiet-rsbuild-preview.md b/.changeset/quiet-rsbuild-preview.md
@@ -0,0 +1,8 @@
+---
+'@tanstack/start-plugin-core': patch
+'@tanstack/react-start': patch
+---
+
+Fix Rsbuild preview support for TanStack Start SSR and rename the middleware option to `installServerMiddleware`.
+
+Deduplicate `react` and `react-dom` in the React Start Rsbuild integration.
diff --git a/benchmarks/bundle-size/package.json b/benchmarks/bundle-size/package.json
@@ -17,7 +17,7 @@
     "vue": "^3.5.16"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tanstack/router-plugin": "workspace:^",
     "@types/react": "^19.0.8",

diff --git a/e2e/react-router/rspack-basic-file-based/package.json b/e2e/react-router/rspack-basic-file-based/package.json
@@ -18,7 +18,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tailwindcss/postcss": "^4.2.2",
     "@tanstack/router-e2e-utils": "workspace:^",

diff --git a/e2e/react-router/rspack-basic-virtual-named-export-config-file-based/package.json b/e2e/react-router/rspack-basic-virtual-named-export-config-file-based/package.json
@@ -18,7 +18,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tailwindcss/postcss": "^4.2.2",
     "@tanstack/router-e2e-utils": "workspace:^",

diff --git a/e2e/react-start/basic/package.json b/e2e/react-start/basic/package.json
@@ -12,6 +12,7 @@
     "build:vite": "vite build && tsc --noEmit",
     "build:rsbuild": "rsbuild build && tsc --noEmit",
     "preview": "vite preview",
+    "preview:rsbuild": "rsbuild preview",
     "start": "node server.js",
     "test:e2e:startDummyServer": "node -e 'import(\"./tests/setup/global.setup.ts\").then(m => m.default())' & node -e 'import(\"./tests/setup/waitForDummyServer.ts\").then(m => m.default())'",
     "test:e2e:stopDummyServer": "node -e 'import(\"./tests/setup/global.teardown.ts\").then(m => m.default())'",
@@ -31,7 +32,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tailwindcss/postcss": "^4.2.2",
     "@tailwindcss/vite": "^4.2.2",
@@ -86,6 +87,10 @@
         {
           "toolchain": "rsbuild",
           "mode": "prerender"
+        },
+        {
+          "toolchain": "rsbuild",
+          "mode": "preview"
         }
       ]
     }

diff --git a/e2e/react-start/basic/playwright.config.ts b/e2e/react-start/basic/playwright.config.ts
@@ -7,6 +7,7 @@ import {
 import packageJson from './package.json' with { type: 'json' }
 
 const mode = process.env.MODE ?? 'ssr'
+const toolchain = process.env.E2E_TOOLCHAIN ?? 'vite'
 const e2ePortKey = process.env.E2E_PORT_KEY ?? packageJson.name
 const distDir = process.env.E2E_DIST_DIR ?? 'dist'
 
@@ -24,9 +25,13 @@ const PORT = await getTestServerPort(e2ePortKey)
 const START_PORT = await getTestServerPort(`${e2ePortKey}_start`)
 const EXTERNAL_PORT = await getDummyServerPort(e2ePortKey)
 const baseURL = `http://localhost:${PORT}`
+const previewCommand =
+  toolchain === 'rsbuild'
+    ? `pnpm preview:rsbuild --port ${PORT}`
+    : `pnpm preview --outDir ${distDir} --port ${PORT}`
 const commandByMode =
   mode === 'preview'
-    ? `pnpm run test:e2e:startDummyServer && pnpm preview --outDir ${distDir} --port ${PORT}`
+    ? `pnpm run test:e2e:startDummyServer && ${previewCommand}`
     : `pnpm run test:e2e:startDummyServer && pnpm start`
 /**
  * See https://playwright.dev/docs/test-configuration.
@@ -50,6 +55,7 @@ export default defineConfig({
     stdout: 'pipe',
     env: {
       MODE: mode,
+      E2E_TOOLCHAIN: toolchain,
       VITE_NODE_ENV: 'test',
       VITE_EXTERNAL_PORT: String(EXTERNAL_PORT),
       VITE_SERVER_PORT: String(PORT),

diff --git a/e2e/react-start/css-inline/package.json b/e2e/react-start/css-inline/package.json
@@ -24,7 +24,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tanstack/router-e2e-utils": "workspace:^",
     "@types/node": "^22.10.2",

diff --git a/e2e/react-start/custom-server-rsbuild/package.json b/e2e/react-start/custom-server-rsbuild/package.json
@@ -21,7 +21,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tailwindcss/postcss": "^4.2.2",
     "@tanstack/router-e2e-utils": "workspace:^",

diff --git a/e2e/react-start/custom-server-rsbuild/rsbuild.config.ts b/e2e/react-start/custom-server-rsbuild/rsbuild.config.ts
@@ -28,10 +28,10 @@ import { tanstackStart } from '@tanstack/react-start/plugin/rsbuild'
 //     explicit prefix.
 export default defineConfig({
   plugins: [
-    pluginReact(),
+    pluginReact({ splitChunks: false }),
     tanstackStart({
       rsbuild: {
-        installDevServerMiddleware: false,
+        installServerMiddleware: false,
         client: {
           output: 'iife',
         },

diff --git a/e2e/react-start/deferred-hydration/package.json b/e2e/react-start/deferred-hydration/package.json
@@ -26,7 +26,7 @@
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.1",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tanstack/router-e2e-utils": "workspace:^",
     "@types/node": "^22.10.2",

diff --git a/e2e/react-start/hmr/package.json b/e2e/react-start/hmr/package.json
@@ -21,7 +21,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tailwindcss/postcss": "^4.2.2",
     "@tailwindcss/vite": "^4.2.2",

diff --git a/e2e/react-start/import-protection/package.json b/e2e/react-start/import-protection/package.json
@@ -25,7 +25,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tanstack/router-e2e-utils": "workspace:^",
     "@types/node": "^22.10.2",

diff --git a/e2e/react-start/rsc/package.json b/e2e/react-start/rsc/package.json
@@ -40,7 +40,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tanstack/eslint-plugin-start": "workspace:^",
     "@tanstack/router-e2e-utils": "workspace:^",

diff --git a/e2e/react-start/server-functions/package.json b/e2e/react-start/server-functions/package.json
@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tailwindcss/postcss": "^4.2.2",
     "@tailwindcss/vite": "^4.2.2",

diff --git a/e2e/solid-router/rspack-basic-file-based/package.json b/e2e/solid-router/rspack-basic-file-based/package.json
@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-babel": "^1.1.2",
     "@rsbuild/plugin-solid": "^1.1.1",
     "@tailwindcss/postcss": "^4.2.2",

diff --git a/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/package.json b/e2e/solid-router/rspack-basic-virtual-named-export-config-file-based/package.json
@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-babel": "^1.1.2",
     "@rsbuild/plugin-solid": "^1.1.1",
     "@tailwindcss/postcss": "^4.2.2",

diff --git a/e2e/solid-start/basic/package.json b/e2e/solid-start/basic/package.json
@@ -27,7 +27,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-babel": "^1.1.2",
     "@rsbuild/plugin-solid": "^1.1.1",
     "@tailwindcss/postcss": "^4.2.2",

diff --git a/e2e/solid-start/deferred-hydration/package.json b/e2e/solid-start/deferred-hydration/package.json
@@ -23,7 +23,7 @@
     "solid-js": "^1.9.10"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.1",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-babel": "^1.1.2",
     "@rsbuild/plugin-solid": "^1.1.1",
     "@tanstack/router-e2e-utils": "workspace:^",

diff --git a/e2e/vue-router/rspack-basic-file-based/package.json b/e2e/vue-router/rspack-basic-file-based/package.json
@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-babel": "^1.1.2",
     "@rsbuild/plugin-vue": "^1.2.7",
     "@rsbuild/plugin-vue-jsx": "^2.0.0",

diff --git a/e2e/vue-router/rspack-basic-virtual-named-export-config-file-based/package.json b/e2e/vue-router/rspack-basic-virtual-named-export-config-file-based/package.json
@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-babel": "^1.1.2",
     "@rsbuild/plugin-vue": "^1.2.7",
     "@rsbuild/plugin-vue-jsx": "^2.0.0",

diff --git a/e2e/vue-start/basic/package.json b/e2e/vue-start/basic/package.json
@@ -27,7 +27,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.50.1",
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-babel": "^1.0.5",
     "@rsbuild/plugin-vue": "^1.2.2",
     "@rsbuild/plugin-vue-jsx": "^1.1.1",

diff --git a/examples/react/quickstart-rspack-file-based/package.json b/examples/react/quickstart-rspack-file-based/package.json
@@ -17,7 +17,7 @@
     "tailwindcss": "^4.2.2"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-react": "^2.0.0",
     "@tanstack/router-plugin": "^1.168.14",
     "@types/react": "^19.0.8",

diff --git a/examples/solid/quickstart-rspack-file-based/package.json b/examples/solid/quickstart-rspack-file-based/package.json
@@ -16,7 +16,7 @@
     "tailwindcss": "^4.2.2"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@rsbuild/plugin-babel": "^1.1.2",
     "@rsbuild/plugin-solid": "^1.1.1",
     "@tanstack/router-plugin": "^1.168.14",

diff --git a/packages/react-start/package.json b/packages/react-start/package.json
@@ -188,7 +188,7 @@
     }
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@types/node": ">=20"
   }
 }
diff --git a/packages/react-start/src/plugin/rsbuild.ts b/packages/react-start/src/plugin/rsbuild.ts
@@ -10,6 +10,16 @@ import type {
 } from '@tanstack/start-plugin-core/rsbuild'
 import type { RsbuildPlugin } from '@rsbuild/core'
 
+const reactStartRsbuildEnvironmentOverrides = {
+  all: {
+    resolve: {
+      dedupe: ['react', 'react-dom'],
+    },
+  },
+} satisfies NonNullable<
+  TanStackStartRsbuildPluginCoreOptions['rsbuild']
+>['environments']
+
 export function tanstackStart(
   options?: TanStackStartRsbuildInputConfig & { rsc?: { enabled?: boolean } },
 ): RsbuildPlugin {
@@ -20,6 +30,9 @@ export function tanstackStart(
     defaultEntryPaths: reactStartDefaultEntryPaths,
     providerEnvironmentName: RSBUILD_ENVIRONMENT_NAMES.server,
     ssrIsProvider: true,
+    rsbuild: {
+      environments: reactStartRsbuildEnvironmentOverrides,
+    },
   }
 
   if (rscEnabled) {

diff --git a/packages/solid-start/package.json b/packages/solid-start/package.json
@@ -127,7 +127,7 @@
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@tanstack/router-utils": "workspace:*",
     "@types/node": ">=20",
     "vite": "*"

diff --git a/packages/start-plugin-core/package.json b/packages/start-plugin-core/package.json
@@ -109,7 +109,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@rsbuild/core": "^2.0.8",
+    "@rsbuild/core": "^2.0.11",
     "@types/babel__code-frame": "^7.0.6",
     "@types/babel__core": "^7.20.5",
     "@types/node": ">=20",