NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #2367 most downloaded on npm
Modern and scalable routing for React applications
Latest stable
1.171.56
Last release 13 days ago
08 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
645 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Updated dependencies [`d9cf933`]:
d9cf933]:
Updated dependencies [`d533f87`]:
d533f87]:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Updated dependencies [`742941e`]:
742941e]:
Add runtime-configurable inline CSS and opt-in CSS URL templates for transformAssets.
add createCsrfMiddleware based on Sec-Fetch-Site header, auto-apply to unconfigured servers, warn for others
add createCsrfMiddleware based on Sec-Fetch-Site header, auto-apply to unconfigured servers, warn for others (#7373)
Updated dependencies [b1c061a, 038cd12, 201e150, 5ae2ae5]:
Updated dependencies \[`b2908c6`]:
c5811aa]:
Updated dependencies \[`45c4ad8`]:
45c4ad8]:
Parse plain TypeScript files without JSX when a filename is available, preventing angle-bracket type assertions from being interpreted as JSX during r
Parse plain TypeScript files without JSX when a filename is available, preventing angle-bracket type assertions from being interpreted as JSX during route and Start import-protection transforms. (#7342)
Updated dependencies [056337e]:
Updated dependencies [`afa40ef`]:
afa40ef]:
Updated dependencies [`709627f`]:
709627f]:
Updated dependencies [`238ea4a`]:
238ea4a]:
Replace global route metadata with explicit router plugin contexts so multiple router plugin instances cannot cross-transform route files.
Add compiler-driven RSC CSS auto-injection for Start RSC render APIs and wire it into the React Start Vite and Rsbuild adapters. This ensures same-fil
Add compiler-driven RSC CSS auto-injection for Start RSC render APIs and wire it into the React Start Vite and Rsbuild adapters. This ensures same-file CSS module dependencies are discovered for renderServerComponent, createCompositeComponent, and JSX-based renderToReadableStream calls. (#7310)
Also add a configurable server function provider module directive hook used by the React Rsbuild RSC adapter to emit "use server-entry" only for extracted provider files.
Updated dependencies [`4a1e63f`]:
4a1e63f]:
Updated dependencies [`82b0613`]:
82b0613]:
Ignore fully type-only imports and re-exports when collecting import-protection sources so type-only references to protected modules do not trigger vi
Sort server function manifest entries by ID before emitting the resolver module. The serverFnsById map is populated in source-file scan order, which v
serverFnsById map is populated in source-file scan order, which varies across machines and incremental builds, producing non-deterministic key ordering in the emitted __tanstack-start-server-fn-resolver-*.mjs artifact. Stable alphabetic sorting ensures reproducible builds, consistent content hashes, and clean git diff on committed artifacts. (#7287)Updated dependencies [`c992495`]:
c992495]:
Updated dependencies [`b5c4183`]:
b5c4183]:
Updated dependencies [`493148b`]:
493148b]:
Updated dependencies \[`01fab5a`, `c5320d7`, `545a8d3`, `da8c28c`]:
#8863 01fab5a - The Rsbuild plugin keeps the app's server.compress setting instead of always setting it to false. Compression stays off by default: a compressed streamed page reaches the browser only once the stream ends. The optional @rsbuild/core peer is now ^2.0.5, the first version whose compression keeps SSR response headers intact.
#8869 d05c6c6 - Vite dev: Vue Start pre-bundles @tanstack/vue-router > @tanstack/vue-store, as React Start does for @tanstack/react-store. The first page load on a cold dependency cache no longer re-optimizes vue and reloads the page.
Updated dependencies [01fab5a, c5320d7, 545a8d3, da8c28c]:
#8863 01fab5a - The Rsbuild plugin keeps the app's server.compress setting instead of always setting it to false. Compression stays off by default: a compressed streamed page reaches the browser only once the stream ends. The optional @rsbuild/core peer is now ^2.0.5, the first version whose compression keeps SSR response headers intact.
Updated dependencies [446ce1b, ff157f0, 01fab5a, c5320d7, 545a8d3, da8c28c, d66a84b]:
a2ad394]:
Updated dependencies \[`32a3360`, `ed55775`, `63a886d`, `d9b07e8`]:
#8670 32a3360 - Reference agent skills in other packages by their intent load identifier (@tanstack/<package>#<skill>) instead of relative file links that break once packages are installed.
Updated dependencies [32a3360, ed55775, 63a886d, d9b07e8]:
#8670 32a3360 - Reference agent skills in other packages by their intent load identifier (@tanstack/<package>#<skill>) instead of relative file links that break once packages are installed.
Updated dependencies [32a3360, ed55775, 63a886d, d9b07e8]:
#8670 32a3360 - Reference agent skills in other packages by their intent load identifier (@tanstack/<package>#<skill>) instead of relative file links that break once packages are installed.
Updated dependencies [32a3360, 689a7c5, ed55775, 63a886d, d9b07e8]:
Updated dependencies \[`18154b1`]:
18154b1]:
18154b1]:
18154b1]:
#8204 cbbfbe3 - Stream large deferred SSR hydration payloads through a backpressure-aware router transport, fail known setup errors before response creation, and close cancelled or expired transforms safely.
Start now cancels discarded middleware and HEAD response bodies, including plain streams and derived branches.
Server-function raw streams share one ordered response. Arbitrary or sequential consumption can require potentially unbounded buffering of unread data on the client. Cancelling one raw stream discards it locally, while aborting the whole call cancels the response and server work. Consume streams concurrently, cancel unused streams promptly, or use separate calls when independent backpressure is required. A raw stream that exceeds its unread-byte limit now fails alone; sibling streams and the JSON result keep flowing.
The JSON wire shape of a RawStream server-function argument changed. Clients and servers must run matching versions for requests that pass a RawStream.
The frame-protocol constants (FRAME_TYPE_*, MAX_FRAME_PAYLOAD_SIZE, MAX_FRAMED_STREAMS) moved from the @tanstack/start-client-core root to the @tanstack/start-client-core/client-rpc subpath.
Router requests whose Accept header allows neither text/html nor */* now receive 406 Not Acceptable instead of 500.
Framework adapters share the body <Scripts> composition (getSsrBodyScriptParts, composeSsrBodyScripts) and the eager HTML response wrapper (renderSsrHtmlResponse) from @tanstack/router-core.
Solid SSR now emits one document type and renders late lazy errors through route boundaries. A Solid <Await> without a fallback no longer holds the streamed shell; it renders inside the nearest <Suspense> boundary like React and Vue, and now renders falsy resolved values.
Static server functions decode cached RawStream values with the client deserializer plugins.
SSR Query integrations now keep request cleanup and stream ownership aligned with the router lifecycle.
1e371b6]:
Updated dependencies \[`71d9694`, `fdc10fa`]:
Add TanStack Start inline CSS manifest support for SSR so route styles can be embedded in the HTML response and hydrated without duplicate stylesheet links. (#7253)
Updated dependencies [4d864ee]:
Updated dependencies \[`740b0ce`, `d6ba115`]:
createServerEntry keeps the complete callback, including custom error handling, inside the request context and converts errors that escape it. The bui
f243c61 - TanStack Start is stable. To upgrade from a release candidate, follow Migrate from the Release Candidate.#8694 550f478 - Remove the deprecated .inputValidator() from createServerFn and createMiddleware. Use .validator(), which takes the same validator.
#7588 94d6d8e - Keep streaming a page when request middleware returns a response that reads the page body, such as a copy made through a wrapped global Response, a copy in Bun, or a body piped through a transform. Start now disposes a replaced page stream only when nothing reads it. transferResponseBodyOwnership is removed: return the derived response directly.
#7588 94d6d8e - Remove the built-in useSession API. Applications choose a session library, such as iron-session, and save or destroy sessions explicitly before returning or redirecting. Connect a cookie adapter through getCookie and setCookie, or append serialized cookies with appendResponseHeader('set-cookie', cookie). Existing session cookies require a deliberate migration or signing in again with a new cookie name.
createServerEntry keeps the complete callback, including custom error handling, inside the request context and converts errors that escape it. The built-in entry still converts errors automatically. Raw createStartHandler handlers now rethrow the original error. For custom reporting, catch inside createServerEntry, then rethrow for default conversion or return handleStartError(error) to preserve response-helper status, headers, and cookies. Return an explicit Response when choosing a custom error payload.
Response helpers now apply consistently across server routes, SSR, server functions, redirects, errors, and middleware response replacements. Helper setters override returned values; cookie helpers preserve independent cookies and replace matching cookie identities. Use appendResponseHeader('set-cookie', cookie) when adding a serialized cookie without replacing other cookies. Changed responses receive copied headers and reuse the body stream, so applications should inspect the response returned by Start rather than relying on mutation of the original response.
#8696 f243c61 - Require Vite 8 for Vite builds. Vite 7 is no longer supported.
Updated dependencies [94d6d8e, 550f478, 94d6d8e, f3d7ee3, 4104b8e, 94d6d8e, 94d6d8e, 94d6d8e, f243c61, 19524cc]:
#8855 446ce1b - Require Node ^20.19.0 || >=22.12.0 (was >=20.19), so the CommonJS builds can load ESM-only dependencies through require(esm). Node 21 and Node 22.0–22.11 do not enable it by default, so they are no longer supported.
#8851 d250819 - Require Vite 6 or later: the vite peer range is now >=6.0.0. Vite 5 is no longer supported.
1ba19a0 - fix: webpack and Rspack production builds no longer put the code splitter's "will not be code-split" warning, with the route file's absolute path, into the client bundle when the build process's NODE_ENV isn't production. The bundler's mode decides, and a config without mode counts as production, as it does for webpack and Rspack. The warning still prints in the build output.
#8852 94f36c4 - The esbuild plugin now throws when autoCodeSplitting is enabled, and TanStackRouterCodeSplitterEsbuild throws, instead of silently bundling every route without splitting. Route generation with esbuild is unchanged.
#8856 533ca27 - Remove the undocumented plugin.hmr.style option and the HmrOptions type. Each bundler entry now picks its own HMR runtime: the webpack and Rspack entries already forced 'webpack', and on Vite, 'webpack' broke route HMR.
#8853 13b6256 - Remove internal code-splitter APIs: the codeSplittingOptions.compilerPlugins option, and the root-entry exports unpluginRouterCodeSplitterFactory, getObjectPropertyKeyName, CodeSplitCompilerPlugin, ReferenceRouteCompilerPlugin, ReferenceRouteCompilerPluginContext and VirtualRouteSplitNodeCompilerPluginContext.
#8860 b5e2ac9 - Source maps of split routes now point at the route file. On webpack and Rspack (including Rsbuild), a split component or shared code mapped to the wrong line, because unplugin's loader dropped the router plugin's map; unplugin now requires ^3.5.0, which keeps it. The maps of split and shared modules also name the route file itself instead of its ?tsr-split / ?tsr-shared module id, so debuggers bind breakpoints set in the route file.
#8870 f420d4a - Vite route HMR now writes import.meta.hot.accept( out instead of calling it through a hot alias. Vite only treats a module as a hot boundary when the call is spelled out, so an edit of a route file no framework plugin accepts (a .ts route file, or an app without @vitejs/plugin-react) reloaded the page instead of updating the route in place. With React HMR, a route file that declares its own top-level hot binding no longer fails to compile with Duplicate declaration "hot".
Updated dependencies [446ce1b, ad5b3b7, ff157f0]:
vite and @rsbuild/core peers as optional where Start exposes both integrations. (#7249)Updated dependencies \[`446ce1b`, `ff157f0`]:
446ce1b - Require Node ^20.19.0 || >=22.12.0 (was >=20.19), so the CommonJS builds can load ESM-only dependencies through require(esm). Node 21 and Node 22.0–22.11 do not enable it by default, so they are no longer supported.#8857 ad5b3b7 - A pathless layout inside a route group (routes/(group)/_layout.tsx) or a route group's own layout (routes/(group)/route.tsx) is typed with the full path '/' in FileRoutesByPath, like the router gives it at runtime, instead of ''. When no index route claims /, the layout also appears under '/' in FileRoutesByFullPath and FileRoutesByTo, as a pathless layout outside a group already does.
Updated dependencies [446ce1b, ff157f0]:
91a7089]:
Updated dependencies \[`3e016ac`]:
3e016ac]:
8c43c71]:
3e016ac]:
build.cssCodeSplit is disabled. (#7191)@tanstack/router-plugin@1.168.34
16f6892]:
@tanstack/router-plugin@1.168.33
Fix Start virtual module resolution in pnpm workspaces by serving the client entry through a real Vite virtual module. (#7178)
Simplify Start virtual module handling by sharing a single createVirtualModule helper and collapsing internal @tanstack/start-plugin-core imports to the root export surface.
Updated dependencies \[`3e016ac`]:
3e016ac]:
b0817f5]:
328d7e5]:
Updated dependencies \[`3e016ac`]:
3e016ac]:
96ac2d8]:
Updated dependencies \[`5d3785d`, `63d2cc9`]:
51138a8]:
51138a8]:
51138a8]:
105d056]:
Updated dependencies \[`4c89b15`, `cf6ab17`, `0fdf9ff`, `bdaf73a`]:
31882c7]:
656a2a0]:
Updated dependencies \[`3e016ac`]:
3e016ac]:
7e93431]:
95dec51]:
0e2c900]:
Updated dependencies \[`5d3785d`, `63d2cc9`]:
51138a8]:
ea3a665]:
ea3a665]:
ea3a665]:
Reduce React Start SSR manifest payload size by omitting unmatched route assets from dehydrated router state while keeping start-manifest asset serialization deduplicated by shared object identity. (#7157)
This improves SSR HTML size for apps with many routes that share the same CSS assets and adds regression coverage for CSS module hydration, navigation, and start-manifest asset reuse.
Updated dependencies [812792f]:
Updated dependencies \[`4c89b15`, `cf6ab17`, `bdaf73a`]:
51138a8]:
8ec9ca9]:
Updated dependencies \[`31882c7`]:
31882c7]:
c59788c]:
ea3a665]:
b2908c6]:
b2908c6]:
b2908c6]:
Reuse previously discovered server function IDs across compiler instances so custom generateFunctionId values stay stable when duplicate IDs are deduplicated during build. (#7153)
This fixes cases where different build environments could assign different deduped IDs to the same server functions, which could cause requests to resolve to the wrong handler.
Updated dependencies \[`7e93431`]:
7e93431]:
45c4ad8]:
45c4ad8]:
6355bb7]:
Updated dependencies \[`51138a8`]:
51138a8]:
ea3a665]:
b2908c6]:
459057c]:
Updated dependencies \[`44a8c3e`, `5253e70`]:
9cac62a]:
45c4ad8]:
f8ac427]:
Updated dependencies \[`ea3a665`]:
ea3a665]:
b2908c6]:
Updated dependencies \[`84db4a8`, `9cac62a`, `6aefb33`]:
45c4ad8]:
Updated dependencies \[`b2908c6`]:
b2908c6]:
start-plugin-core build that exports the subpaths used by react-start-rsc. (3384abc)Updated dependencies \[`45c4ad8`]:
45c4ad8]:
f7e9c5e]:
Updated dependencies [`796406d`]:
796406d]:
Updated dependencies [`2d1ec86`]:
2d1ec86]:
Updated dependencies [`f8351a8`]:
f8351a8]:
Updated dependencies [`6ee0e79`]:
6ee0e79]:
Updated dependencies [`42c3f3b`]:
42c3f3b]:
Updated dependencies [`70b2225`]:
70b2225]:
Updated dependencies [`cf5f554`]:
cf5f554]:
Updated dependencies [`71a8b68`]:
71a8b68]:
Deduplicate CSS assets in the Start manifest so shared stylesheets are not repeated within a route entry or across an active parent-child route chain.
Updated dependencies [`d81d21a`]:
### Patch Changes - fix: streaming in vite preview
Updated dependencies [`c9e1855`]:
c9e1855]:
Updated dependencies [`9351e99`]:
9351e99]:
Updated dependencies [`91cc628`]:
91cc628]:
Start now cancels discarded middleware and HEAD response bodies, including plain streams and derived branches.
#8204 cbbfbe3 - Stream large deferred SSR hydration payloads through a backpressure-aware router transport, fail known setup errors before response creation, and close cancelled or expired transforms safely.
Start now cancels discarded middleware and HEAD response bodies, including plain streams and derived branches.
Server-function raw streams share one ordered response. Arbitrary or sequential consumption can require potentially unbounded buffering of unread data on the client. Cancelling one raw stream discards it locally, while aborting the whole call cancels the response and server work. Consume streams concurrently, cancel unused streams promptly, or use separate calls when independent backpressure is required. A raw stream that exceeds its unread-byte limit now fails alone; sibling streams and the JSON result keep flowing.
The JSON wire shape of a RawStream server-function argument changed. Clients and servers must run matching versions for requests that pass a RawStream.
The frame-protocol constants (FRAME_TYPE_*, MAX_FRAME_PAYLOAD_SIZE, MAX_FRAMED_STREAMS) moved from the @tanstack/start-client-core root to the @tanstack/start-client-core/client-rpc subpath.
Router requests whose Accept header allows neither text/html nor */* now receive 406 Not Acceptable instead of 500.
Framework adapters share the body <Scripts> composition (getSsrBodyScriptParts, composeSsrBodyScripts) and the eager HTML response wrapper (renderSsrHtmlResponse) from @tanstack/router-core.
Solid SSR now emits one document type and renders late lazy errors through route boundaries. A Solid <Await> without a fallback no longer holds the streamed shell; it renders inside the nearest <Suspense> boundary like React and Vue, and now renders falsy resolved values.
Static server functions decode cached RawStream values with the client deserializer plugins.
SSR Query integrations now keep request cleanup and stream ownership aligned with the router lifecycle.
Updated dependencies [cbbfbe3]:
bbf9b75]:
0545239]:
One column per month.