NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #2454 most downloaded on npm
Modern and scalable routing for React applications
Latest stable
1.169.5
Last release 14 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
3 years old
851 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
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]:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
#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]:
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]:
#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.
18154b1]:
Updated dependencies \[`71d9694`, `fdc10fa`]:
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]:
Updated dependencies \[`2413cc0`, `4191640`, `efc2042`, `efc2042`, `d35aab4`]:
2413cc0, 4191640, efc2042, efc2042, d35aab4]:
Updated dependencies \[`60b8ad1`, `41ebd28`, `614bc27`, `05223c2`, `d521abd`, `ff66a03`, `863c8a7`]:
60b8ad1, 41ebd28, 614bc27, 05223c2, d521abd, ff66a03, 863c8a7]:
Updated dependencies \[`f5ffd38`, `488d046`, `e81845f`, `76a7c0b`]:
f5ffd38, 488d046, e81845f, 76a7c0b]:
Updated dependencies \[`4191640`, `efc2042`, `d35aab4`, `e7ab157`, `efc2042`]:
73bfc15]:
Updated dependencies \[`41ebd28`, `05223c2`, `d521abd`]:
222300b]:
Updated dependencies \[`41ebd28`, `614bc27`, `05223c2`, `d521abd`]:
Updated dependencies \[`e561fa1`, `cbbfbe3`, `a1c8d1a`, `cbbfbe3`, `8e164d2`]:
e561fa1, cbbfbe3, a1c8d1a, cbbfbe3, 8e164d2]:
222300b]:
@tanstack/solid-router@1.170.36
222300b]:
ab99818]:
Updated dependencies \[`e561fa1`, `cbbfbe3`, `a1c8d1a`, `cbbfbe3`]:
b747fb8, 6387d58, 9b2adaf, 634da91, e9396c9, 6387d58, 9872d2a, 7e349c3, e9396c9]:
Updated dependencies \[`ab99818`]:
#8397 ab99818 - Support Rsbuild 2.2: preserve function-based Rspack watch exclusions and regular-expression flags when adding monorepo build-output exclusions, and leave string-valued Babel loader options intact in the Solid Start plugin.
Updated dependencies [ab99818]:
Updated dependencies \[`ab99818`]:
ab99818]:
aee42c6, 49bcd4d, 9c1871c, 9aec5a7, 919c397]:
Updated dependencies [ b1c9219 , 76239a3 , d914b08 ]:
2f20c00, 28a5e45, f0b5eda, 37877da, 0497cae, 0caf6b9, cf166d1]:
Updated dependencies [ 8c43c71 , d914b08 ]:
Updated dependencies \[`32a3360`, `689a7c5`]:
#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.
#8737 647cb73 - Remove the enableRouteGeneration option. Route generation now always runs, so autoCodeSplitting always has the route metadata it needs.
Updated dependencies [32a3360, 689a7c5]:
Updated dependencies [ 2f20c00 , 28a5e45 , f0b5eda , 37877da , 0497cae , 0caf6b9 ]:
18154b1]:
@tanstack/solid-router@1.170.29
0fdf9ff]:
923d98b]:
Updated dependencies \[`5d3785d`]:
5d3785d]:
d6ba115]:
Updated dependencies \[`5d3785d`]:
5d3785d]:
0fdf9ff]:
b0817f5]:
#8655 e66da18 - Remove redundant string excludes from the reference code-splitter transform filter to avoid unnecessary glob compilation in unplugin bundler adapters.
Updated dependencies [57bd1a9, 94d6d8e]:
Updated dependencies \[`0fdf9ff`]:
0fdf9ff]:
f500760, 1aafca9, aa10b65]:
18154b1]:
Updated dependencies \[`31882c7`, `3848503`]:
32a3360]:
d6ba115]:
Updated dependencies \[`f500760`, `1aafca9`, `aa10b65`]:
c59788c]:
18154b1]:
@tanstack/start-client-core@1.170.21
c59788c]:
2fbc99f, 95dec51, 6bede65]:
d6ba115]:
Updated dependencies \[`ea3a665`]:
ea3a665]:
c59788c]:
Updated dependencies \[`2fbc99f`, `6bede65`]:
697ebb6, 2435885, 9cac62a, 86bf510, 6aefb33]:
@tanstack/start-client-core@1.170.18
b2908c6]:
d521abd]:
73bfc15]:
Updated dependencies \[`2435885`, `9cac62a`, `86bf510`, `6aefb33`]:
b2908c6]:
45c4ad8]:
Updated dependencies \[`b2908c6`]:
b2908c6]:
45c4ad8]:
Updated dependencies \[`3e016ac`]:
3e016ac]:
45c4ad8]:
7592555]:
Updated dependencies \[`5d3785d`, `63d2cc9`, `f75cada`]:
fc83c03]:
Nothing published for this version
Updated dependencies \[`4c89b15`, `cf6ab17`, `0fdf9ff`, `bdaf73a`]:
Updated dependencies \[`0c25a7b`, `31882c7`]:
ffdd64e]:
Updated dependencies \[`7e93431`, `f500760`, `1aafca9`, `aa10b65`]:
Updated dependencies \[`3e016ac`]:
3e016ac]:
51138a8]:
Updated dependencies \[`3e016ac`]:
3e016ac]:
Updated dependencies \[`5d3785d`, `63d2cc9`]:
ea3a665]:
ba52d2b]:
Updated dependencies \[`4c89b15`, `cf6ab17`, `0fdf9ff`, `bdaf73a`]:
52db703, 4a93cff, 96eca43, f046b06, e499164, 689d88e, 689c5ab]:
Updated dependencies \[`31882c7`, `3848503`]:
b0817f5]:
b2908c6]:
#7566 9bebf8d - Add validator() as the canonical server function and middleware validator method. Deprecate inputValidator() and emit compiler warnings for remaining uses.
Updated dependencies [9bebf8d]:
Updated dependencies \[`7e93431`, `f500760`, `1aafca9`, `aa10b65`]:
45c4ad8]:
Updated dependencies \[`51138a8`]:
51138a8]:
51138a8]:
Updated dependencies \[`44a8c3e`, `c59788c`, `5253e70`]:
ac10815]:
Updated dependencies \[`2fbc99f`, `6bede65`]:
301f6ba]:
Updated dependencies \[`ea3a665`]:
ea3a665]:
ea3a665]:
8091918]:
Updated dependencies \[`2435885`, `84db4a8`, `9cac62a`, `86bf510`, `6aefb33`]:
Updated dependencies \[`b2908c6`]:
b2908c6]:
b2908c6]:
Updated dependencies \[`45c4ad8`]:
45c4ad8]:
#7505 2f53749 - Preserve primitive values thrown from beforeLoad error handling.
Updated dependencies [2f53749]:
Updated dependencies [`d1997b6`]:
d1997b6]:
Updated dependencies [`9c09bca`]:
9c09bca]:
Updated dependencies [`71fb329`]:
Fix serialization adapter module resolution in TanStack Start. Vite dev now uses clean runtime-specific virtual module IDs instead of browser requests
Fix serialization adapter module resolution in TanStack Start. Vite dev now uses clean runtime-specific virtual module IDs instead of browser requests containing encoded null-byte virtual IDs, which avoids reverse proxy failures. When no serialization adapters are configured, Vite and Rsbuild now resolve #tanstack-start-plugin-adapters through the package empty-adapter fallback. (#7484)
Publish matching TanStack Start dev server packages so fresh installs do not pair a Start plugin that no longer provides tanstack-start-injected-head-scripts:v with an older Start server runtime that still imports it. (#7487)
Updated dependencies [a82cec6, d8be4f8]:
Add Vite bundled dev mode support for TanStack Start. Start now recognizes Vite's experimental.bundledDev opt-in, uses the bundled dev client entry in
Add Vite bundled dev mode support for TanStack Start. Start now recognizes Vite's experimental.bundledDev opt-in, uses the bundled dev client entry in the dev manifest, keeps server requests pointed at the latest client build output, and preserves import-protection behavior for bundled client dev. (#7482)
Updated dependencies [90adda9]:
Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments.
Add support for Rsbuild client output formats, including module output by default and IIFE output for classic script environments. (#7477)
Client entry scripts and preloads are now represented as root route manifest assets, script preloads follow the manifest script format, and script asset cross-origin configuration uses the script key. The transformAssets script callback context now exposes only kind: 'script' and url, keeping script format handling internal to manifest rendering.
Fix Rsbuild server function metadata replay when Rspack restores modules from its persistent cache. (#7477)
Server function metadata is now stored on Rspack module build info and replayed from cached modules before resolver modules are rebuilt, preventing warm restarts from losing server function registrations.
Updated dependencies [51a97a1, 51a97a1]:
Explicitly re-export public API names from @tanstack/start-client-core (createServerFn, createMiddleware, createStart, createCsrfMiddleware, createIso
Explicitly re-export public API names from @tanstack/start-client-core (createServerFn, createMiddleware, createStart, createCsrfMiddleware, createIsomorphicFn, createClientOnlyFn, createServerOnlyFn) alongside the existing export *. The explicit named re-exports are registered at link time (via Vite SSR's defineExport at fileStartIndex), so the namespace has these getters before any import body runs — survives the cold-start SSR cycle through user middleware where export * would otherwise produce a partial facade (createMiddleware is not a function). Workaround for vitejs/vite#22491 / #22493. (#7466)
Updated dependencies []:
@tanstack/start-plugin-core@1.171.2
One column per quarter.