NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #2369 most downloaded on npm
Modern and scalable routing for React applications
Latest stable
1.167.52
Last release 1 months ago
22 Oct 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
561 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Updated dependencies \[`32a3360`, `689a7c5`]:
Updated dependencies \[`18154b1`]:
18154b1]:
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Updated dependencies \[`32a3360`]:
32a3360]:
32a3360]:
71d9694]:
Updated dependencies \[`18154b1`]:
18154b1]:
18154b1]:
Updated dependencies \[`32a3360`, `647cb73`]:
#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.
Updated dependencies [94d6d8e, 94d6d8e, 94d6d8e, 94d6d8e, 94d6d8e, 94d6d8e]:
71d9694]:
@tanstack/router-plugin@1.168.47
@tanstack/router-generator@1.167.46
#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.
Updated dependencies [94d6d8e, 94d6d8e, 94d6d8e, 94d6d8e, 94d6d8e, 94d6d8e]:
32a3360]:
Updated dependencies \[`32a3360`]:
32a3360]:
18154b1]:
Updated dependencies \[`18154b1`]:
18154b1]:
32a3360]:
#8711 a80cd74 - Replace yargs with the dependency-free cac for parsing tsr arguments. tsr generate and tsr watch work as before. Running tsr with no command now prints help, and unknown commands, unknown options, or extra arguments now print an error and exit with code 1 instead of being ignored.
Updated dependencies []:
e66da18]:
923d98b]:
73bfc15]:
d521abd]:
Updated dependencies \[`d6ba115`]:
d6ba115]:
d6ba115]:
@tanstack/start-client-core@1.170.37
57bd1a9]:
Updated dependencies \[`32a3360`]:
32a3360]:
#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 [bc80866, e561fa1, cbbfbe3, a1c8d1a, cbbfbe3, a0b2ad9, 1ca361b]:
d76a332, b747fb8, 6cfb1e8, 700a714, 700a714, 6387d58, 7e349c3, 9b2adaf, 873c830, 7e349c3, 634da91, e9396c9, 634da91, f151ab0, bc57fa3, 6387d58, 9872d2a, d76a332, 634da91, 634da91, 7e349c3, 9448caa, e9396c9, 700a714, 634da91, 634da91]:
Updated dependencies \[`d521abd`]:
d521abd]:
d76a332, b747fb8, 6cfb1e8, 700a714, 700a714, cb8749e, 7e349c3, 9b2adaf, 873c830, 7e349c3, 634da91, e9396c9, 634da91, f151ab0, bc57fa3, 9872d2a, 9b2adaf, d76a332, 634da91, 634da91, 7e349c3, 9448caa, e9396c9, 700a714, 634da91, 634da91]:
18154b1]:
Updated dependencies [ 8c43c71 , d914b08 ]:
#8451 740b0ce - Skip request middleware bookkeeping when no request middleware is configured, and stop copying serialization adapters when the router adds none.
Server route handlers and route middleware now receive the router's decoded pathname, the same one used for route matching. Characters that would change how the path is read, such as %2F, %3F, and %23, stay encoded.
Updated dependencies [d6ba115]:
Updated dependencies \[`cecae54`, `0103578`, `ce10dcd`, `84936cc`, `bbd2336`]:
#8297 488d046 - Update seroval and seroval-plugins from 1.6.2 to 1.6.7. This picks up the typed array length guard, the maxBase64Length and compactArrayBufferViews options, and the isStream export.
Updated dependencies [488d046, 76a7c0b]:
#7588 94d6d8e - Reduce per-request work in Start: getNormalizedURL reads a URL input without cloning it, and runWithStartContext returns the callback's own result instead of wrapping it in a promise, so a synchronous throw from the callback now propagates synchronously.
Updated dependencies [94d6d8e]:
Updated dependencies [ edf0e16 , 2f20c00 , 28a5e45 , 08eff50 , 216c0c4 , 2f91503 , f0b5eda , 50eafca , 0497cae , 0caf6b9 , ee28348 , c18e690 ]:
Updated dependencies [ fa65287 , cb281d7 ]:
#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]:
d76a332, b747fb8, 6cfb1e8, 700a714, 700a714, cb8749e, 7e349c3, 9b2adaf, 873c830, 7e349c3, 634da91, e9396c9, 634da91, f151ab0, bc57fa3, 9872d2a, 9b2adaf, d76a332, 634da91, 634da91, 7e349c3, 9448caa, e9396c9, 700a714, 634da91, 634da91]:
d521abd]:
3e016ac]:
Updated dependencies [ 8c43c71 ]:
8c43c71]:
Updated dependencies \[`5d3785d`, `63d2cc9`]:
@tanstack/router-plugin@1.168.33
Updated dependencies \[`3e016ac`]:
3e016ac]:
b0817f5]:
Updated dependencies \[`3e016ac`]:
3e016ac]:
Updated dependencies \[`5d3785d`, `63d2cc9`]:
51138a8]:
51138a8]:
51138a8]:
Updated dependencies \[`31882c7`]:
31882c7]:
Updated dependencies \[`3e016ac`]:
3e016ac]:
7e93431]:
95dec51]:
Updated dependencies \[`ea3a665`]:
ea3a665]:
51138a8]:
ea3a665]:
ea3a665]:
Updated dependencies \[`4c89b15`, `cf6ab17`, `bdaf73a`]:
51138a8]:
Updated dependencies \[`31882c7`]:
31882c7]:
c59788c]:
ea3a665]:
b2908c6]:
b2908c6]:
b2908c6]:
Updated dependencies \[`7e93431`]:
7e93431]:
45c4ad8]:
45c4ad8]:
45c4ad8]:
Updated dependencies \[`51138a8`]:
51138a8]:
ea3a665]:
b2908c6]:
65f7b7f]:
Nothing published for this version
Updated dependencies \[`44a8c3e`, `5253e70`]:
9cac62a]:
45c4ad8]:
e2dd204]:
Updated dependencies \[`ea3a665`]:
ea3a665]:
b2908c6]:
9809a06]:
Updated dependencies \[`84db4a8`, `9cac62a`, `6aefb33`]:
45c4ad8]:
Updated dependencies \[`b2908c6`]:
b2908c6]:
Updated dependencies \[`45c4ad8`]:
45c4ad8]:
776d8ef]:
Updated dependencies [`df1076c`]:
df1076c]:
Updated dependencies [`ac10815`]:
ac10815]:
Updated dependencies [`2cca73c`, `7a83e67`, `76b3d3b`]:
Updated dependencies [`b4cd5af`]:
b4cd5af]:
Updated dependencies [`9cb7a00`]:
9cb7a00]:
Updated dependencies [`2f53749`]:
2f53749]:
Updated dependencies [`d1997b6`]:
d1997b6]:
Updated dependencies [`9c09bca`]:
9c09bca]:
Updated dependencies [`a82cec6`, `d8be4f8`]:
Updated dependencies [`51a97a1`]:
51a97a1]:
Updated dependencies [`5268ba4`]:
5268ba4]:
Updated dependencies [`0300f87`, `0300f87`]:
Updated dependencies [`5fa9e55`]:
5fa9e55]:
Updated dependencies [`b60eb36`]:
b60eb36]:
Updated dependencies \[`bbf9b75`]:
bbf9b75]:
#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]:
d9cf933]:
Updated dependencies \[`d76a332`, `b747fb8`, `6cfb1e8`, `700a714`, `700a714`, `cb8749e`, `7e349c3`, `9b2adaf`, `873c830`, `7e349c3`, `634da91`, `e9396
d76a332, b747fb8, 6cfb1e8, 700a714, 700a714, cb8749e, 7e349c3, 9b2adaf, 873c830, 7e349c3, 634da91, e9396c9, 634da91, f151ab0, bc57fa3, 9872d2a, 9b2adaf, d76a332, 634da91, 634da91, 7e349c3, 9448caa, e9396c9, 700a714, 634da91, 634da91]:
d533f87]:
Updated dependencies \[`45c4ad8`]:
45c4ad8]:
45c4ad8]:
45c4ad8]:
2387a2e]:
Updated dependencies [`b1c061a`, `201e150`, `5ae2ae5`]:
Updated dependencies [`35e88f0`]:
35e88f0]:
Updated dependencies [`afa40ef`]:
afa40ef]:
Add opt-in Start response Link headers for collected Early Hints.
Add experimental HTTP 103 Early Hints support to Start server handlers.
Updated dependencies [`4a1e63f`]:
4a1e63f]:
Updated dependencies [`82b0613`]:
82b0613]:
One column per month.