fix react server exports for start and react-router

[schiller-manuel]

Summary by CodeRabbit

Release Notes

• New Features

  • Added React Server Component support with a new react-server export condition for proper handling of notFound() and redirect() in server functions.
  • Added example routes demonstrating server-side notFound() and redirect() behavior with support for both SSR and client-side navigation.

• Tests

  • Added E2E tests validating server function notFound() and redirect() behavior across SSR and client-side navigation scenarios.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 1dc6fc08-f185-4105-8095-d252a67342c6

📥 Commits

Reviewing files that changed from the base of the PR and between f1a4973 and 9f000db.

📒 Files selected for processing (11)

• .changeset/neat-melons-worry.md
• e2e/react-start/rsc/src/routeTree.gen.ts
• e2e/react-start/rsc/src/routes/__root.tsx
• e2e/react-start/rsc/src/routes/index.tsx
• e2e/react-start/rsc/src/routes/rsc-server-not-found.tsx
• e2e/react-start/rsc/src/routes/rsc-server-redirect.tsx
• e2e/react-start/rsc/tests/rsc-server-not-found.spec.ts
• e2e/react-start/rsc/tests/rsc-server-redirect.spec.ts
• packages/react-router/package.json
• packages/react-router/src/index.rsc.ts
• packages/react-router/vite.config.ts

---

📝 Walkthrough

Walkthrough

React Server Component support is introduced to @tanstack/react-router via a new react-server root export that re-exports core functions from @tanstack/router-core. Two new test routes and corresponding e2e specs validate that server functions invoking notFound() or redirect() behave correctly across SSR and client navigation scenarios.

Changes

Cohort / File(s)	Summary
Changeset Metadata .changeset/neat-melons-worry.md	Patch release changeset documenting the addition of react-server root export for RSC support.
Package Configuration packages/react-router/package.json, packages/react-router/vite.config.ts	Added react-server export condition pointing to new RSC entry files; extended Vite build entry list to include index.rsc.ts.
RSC Source Entrypoint packages/react-router/src/index.rsc.ts	New RSC-safe module re-exporting all standard exports plus explicit re-exports of notFound, redirect, and related utilities from core package.
E2E Route Tree & Navigation e2e/react-start/rsc/src/routeTree.gen.ts, e2e/react-start/rsc/src/routes/__root.tsx, e2e/react-start/rsc/src/routes/index.tsx	Generated route tree updated with two new routes; navigation links and example list entries added for /rsc-server-not-found and /rsc-server-redirect.
E2E Test Routes e2e/react-start/rsc/src/routes/rsc-server-not-found.tsx, e2e/react-start/rsc/src/routes/rsc-server-redirect.tsx	New routes demonstrating server functions invoking notFound() and redirect() respectively, with dedicated boundary/component rendering.
E2E Test Specs e2e/react-start/rsc/tests/rsc-server-not-found.spec.ts, e2e/react-start/rsc/tests/rsc-server-redirect.spec.ts	Playwright e2e test suites validating notFound and redirect behavior during both SSR and client-side navigation scenarios.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 A server route speaks with a voice so clear,
When notFound() whispers, boundaries appear!
And redirect() dances, swift as a hare,
RSC flows now everywhere! 🌟

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: adding React Server Component exports for the react-router package.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch fix-rsc-export-notfound

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 7740e34

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	❌ Failed	13m 4s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	1s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-04-13 22:59:49 UTC

[github-actions]

🚀 Changeset Version Preview

1 package(s) bumped directly, 4 bumped as dependents.

🟩 Patch bumps

Package	Version	Reason
@tanstack/react-router	1.168.19 → 1.168.20	Changeset
@tanstack/react-start	1.167.37 → 1.167.38	Dependent
@tanstack/react-start-client	1.166.36 → 1.166.37	Dependent
@tanstack/react-start-rsc	0.0.16 → 0.0.17	Dependent
@tanstack/react-start-server	1.166.37 → 1.166.38	Dependent

[github-actions]

Bundle Size Benchmarks

• Commit: f1a4973d41dc
• Measured at: 2026-04-13T22:47:35.611Z
• Baseline source: history:7324b98d114b
• Dashboard: bundle-size history

Scenario	Current (gzip)	Delta vs baseline	Raw	Brotli	Trend
react-router.minimal	87.33 KiB	0 B (0.00%)	274.58 KiB	75.97 KiB	█▇▇▇▇▇▁▁▁▁▁
react-router.full	90.59 KiB	0 B (0.00%)	285.66 KiB	78.72 KiB	██████▁▁▁▁▁
solid-router.minimal	35.50 KiB	0 B (0.00%)	106.58 KiB	31.88 KiB	█▇▇▇▇▇▁▁▁▁▁
solid-router.full	39.98 KiB	0 B (0.00%)	120.08 KiB	35.93 KiB	██████▁▁▁▁▁
vue-router.minimal	53.30 KiB	0 B (0.00%)	151.99 KiB	47.86 KiB	██████▁▁▁▁▁
vue-router.full	58.19 KiB	0 B (0.00%)	167.41 KiB	52.09 KiB	██████▁▁▁▁▁
react-start.minimal	101.73 KiB	0 B (0.00%)	322.31 KiB	87.94 KiB	██████▁▁▁▁▁
react-start.full	105.17 KiB	0 B (0.00%)	332.64 KiB	90.84 KiB	█▇▇▇▇▇▁▁▁▁▁
solid-start.minimal	49.50 KiB	0 B (0.00%)	152.39 KiB	43.63 KiB	██████▁▁▁▁▁
solid-start.full	55.03 KiB	0 B (0.00%)	168.60 KiB	48.41 KiB	██████▁▁▁▁▁

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

[pkg-pr-new]

More templates

• tanstack-router-vue-example-basic-jsx
• tanstack-router-vue-example-basic-file-based-jsx
• tanstack-router-vue-example-basic-file-based-sfc
• tanstack-router-solid-example-authenticated-routes
• tanstack-router-solid-example-authenticated-routes-firebase
• tanstack-router-solid-example-basic
• tanstack-router-solid-example-basic-default-search-params
• tanstack-router-solid-example-basic-devtools-panel
• tanstack-router-solid-example-basic-file-based
• tanstack-router-solid-example-basic-non-nested-devtools
• tanstack-router-solid-example-basic-solid-query
• tanstack-router-solid-example-basic-solid-query-file-based
• tanstack-router-solid-example-basic-ssr-file-based
• tanstack-router-solid-example-basic-ssr-streaming-file-based
• tanstack-router-solid-example-basic-virtual-file-based
• tanstack-router-solid-example-basic-virtual-inside-file-based
• tanstack-router-solid-example-deferred-data
• tanstack-router-solid-i18n-paraglide
• tanstack-router-solid-example-kitchen-sink
• tanstack-router-solid-example-kitchen-sink-file-based
• tanstack-router-solid-example-kitchen-sink-solid-query
• tanstack-router-solid-example-kitchen-sink-solid-query-file-based
• tanstack-router-solid-example-large-file-based
• tanstack-router-solid-example-location-masking
• tanstack-router-solid-example-navigation-blocking
• tanstack-router-solid-example-quickstart
• tanstack-router-solid-example-quickstart-esbuild-file-based
• tanstack-router-solid-example-quickstart-file-based
• tanstack-router-solid-example-quickstart-rspack-file-based
• tanstack-router-solid-example-quickstart-webpack-file-based
• @tanstack/router-solid-mono-simple
• router-solid-mono-simple-lazy
• router-solid-monorepo-solid-query
• tanstack-router-solid-example-scroll-restoration
• tanstack-solid-router-search-validator-adapters
• tanstack-solid-start-example-basic
• tanstack-solid-start-example-basic-auth
• tanstack-solid-start-example-basic-authjs
• tanstack-solid-start-example-basic-cloudflare
• tanstack-solid-start-example-basic-netlify
• tanstack-solid-start-example-basic-nitro
• tanstack-start-example-basic-solid-query
• tanstack-solid-start-example-basic-static
• tanstack-solid-start-bun-hosting
• tanstack-solid-start-example-convex-better-auth
• tanstack-solid-start-example-counter
• tanstack-solid-start-i18n-paraglide
• tanstack-solid-start-example-large
• tanstack-solid-start-streaming-data-from-server-functions
• tanstack-solid-start-example-supabase-basic
• tanstack-solid-start-tailwind-v4
• tanstack-router-solid-example-view-transitions
• tanstack-router-solid-example-with-framer-motion
• tanstack-router-solid-example-with-trpc
• tanstack-router-react-example-authenticated-routes
• tanstack-router-react-example-authenticated-routes-firebase
• tanstack-router-react-example-basic
• tanstack-router-react-example-basic-default-search-params
• tanstack-router-react-example-basic-devtools-panel
• tanstack-router-react-example-basic-file-based
• tanstack-router-react-example-basic-non-nested-devtools
• tanstack-router-react-example-react-query
• tanstack-router-react-example-basic-react-query-file-based
• tanstack-router-react-example-basic-ssr-file-based
• tanstack-router-react-example-basic-ssr-streaming-file-based
• tanstack-router-react-example-basic-virtual-file-based
• tanstack-router-react-example-basic-virtual-inside-file-based
• tanstack-router-react-example-deferred-data
• tanstack-router-i18n-paraglide
• tanstack-router-react-example-kitchen-sink
• tanstack-router-react-example-kitchen-sink-file-based
• tanstack-router-react-example-kitchen-sink-react-query
• tanstack-router-react-example-kitchen-sink-react-query-file-based
• tanstack-router-react-example-large-file-based
• tanstack-router-react-example-location-masking
• tanstack-router-react-example-navigation-blocking
• tanstack-router-react-example-quickstart
• tanstack-router-react-example-quickstart-esbuild-file-based
• tanstack-router-react-example-quickstart-file-based
• tanstack-router-react-example-quickstart-rspack-file-based
• tanstack-router-react-example-quickstart-webpack-file-based
• router-monorepo-react-query
• router-mono-simple
• router-mono-simple-lazy
• tanstack-router-react-example-scroll-restoration
• tanstack-search-validator-adapters
• tanstack-start-example-bare
• tanstack-start-example-basic
• tanstack-start-example-basic-auth
• tanstack-router-react-example-basic-authjs
• tanstack-start-example-basic-cloudflare
• tanstack-start-example-basic-react-query
• tanstack-start-example-basic-static
• tanstack-start-bun-hosting
• tanstack-start-example-clerk-basic
• tanstack-start-example-convex-trellaux
• tanstack-start-example-counter
• tanstack-start-i18n-paraglide
• tanstack-start-example-large
• tanstack-start-example-material-ui
• tanstack-start-example-rscs
• tanstack-start-streaming-data-from-server-functions
• tanstack-start-example-supabase-basic
• tanstack-start-tailwind-v4
• tanstack-start-example-trellaux
• tanstack-start-example-workos
• tanstack-router-react-example-view-transitions
• tanstack-router-react-example-with-framer-motion
• tanstack-router-react-example-with-trpc
• tanstack-router-react-example-with-trpc-react-query

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@7183

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@7183

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@7183

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@7183

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@7183

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@7183

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@7183

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@7183

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@7183

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@7183

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@7183

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@7183

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@7183

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@7183

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@7183

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@7183

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@7183

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@7183

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@7183

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@7183

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@7183

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@7183

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@7183

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@7183

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@7183

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@7183

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@7183

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@7183

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@7183

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@7183

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@7183

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@7183

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@7183

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@7183

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@7183

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@7183

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@7183

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@7183

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@7183

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@7183

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@7183

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@7183

commit: 7740e34

[codspeed-hq]

Merging this PR will not alter performance

✅ 6 untouched benchmarks

---

_{Comparing fix-rsc-export-notfound (7740e34) with main (7324b98)¹}

Footnotes

1. No successful run was found on main (f1a4973) during the generation of this report, so 7324b98 was used instead as the comparison base. There might be some changes unrelated to this pull request in this report. ↩

[nx-cloud]

Nx Cloud has identified a flaky task in your failed CI:

🔂 Since the failure was identified as flaky, we triggered a CI rerun by adding an empty commit to this branch.

View detailed reasoning in Nx Cloud ↗

_{🎓 Learn more about Self-Healing CI on nx.dev}