0
Fork 0
mirror of https://github.com/TanStack/router.git synced 2026-11-16 19:38:07 +00:00
🤖 A client-first, server-capable, fully type-safe router and full-stack framework for the web (React and more). https://tanstack.com/router
  • TypeScript 98.2%
  • JavaScript 1.2%
  • CSS 0.4%
  • Vue 0.1%
  • HTML 0.1%
Find a file
Sheraff c03e696f3e
test(start-plugin-core): planner tests check names by shape, not by spelling
Which name the core's allocator generates for glue is free, so the planner
tests read it from the output (`tests/generated-names.ts`: `shape`,
`namesIn`, `importedAs`) instead of spelling `TsrHydrate0`, `tsrLazy`,
`tsrArguments`, `tsrCap$…`, `tsrRef$…`, `props$1`, `tsrClientRpc`,
`tsrSsrRpc`, `tsrServerRpc`, `tsrLoadHandlers`, `tsrHandler$…`,
`tsrServerFn$…` or `*_createServerFn_handler`; whole-chunk `toBe`s are
checks of what the test is about. Kept as they were: diagnostics (code and
position), hydration and derived ids, source-map positions, edges, facts.

Deleted from planners/hydrate.test.ts, behaviour covered by the Hydrate
oracle (pages/ on a Vite dev server, hydrate-build*, hydrate-pages*):
- import forms are boundaries: hydrate-boundary-forms "a renamed import of
  Hydrate is a boundary", hydrate-pages "a namespace-imported Start.Hydrate
  loads its children when it hydrates", hydrate-split-modules "client:
  modules and bindings only the split children use are not needed before
  the chunk loads"
- split shorthand and dynamic split: hydrate-split-modules "client: the
  split shorthand splits the children", hydrate-boundary-forms "a dynamic
  split={flag} (%s) still splits the children"
- Solid loads through the Solid router: hydrate-boundary-forms "Solid: a
  Hydrate of @tanstack/solid-start splits with the Solid packages"
- a single expression child: hydrate-split-modules "client: a single
  expression child ($name) renders through the chunk"
- a self-closing boundary's children prop and boundaries nested in it:
  hydrate-split-modules "client: the children prop ($name) of a
  self-closing boundary is deferred", known-bugs-hydrate "client: a boundary
  nested in a children prop hydrates with the id the server renders"
- generated names away from the file universe: hydrate-captures "client:
  $scope bindings named like the generated bindings keep their values",
  known-bugs-hydrate-module-level "client: module-level $name, named like
  the generated bindings, do not collide"
- a chunk-first request: hydrate-build-dev "client: a chunk requested
  before its parent module renders the children, and an edit reaches it"
- captured locals, JSX tags of locals, names bound inside, local enums,
  own this/arguments of inner functions, nested placeholders: hydrate-
  captures "client: the children read the locals of the component $name",
  "client: a nested boundary reads the locals of the component around its
  enclosing boundary"; known-bugs-hydrate "client: the split children render
  a local component named %s", "… render a component bound inside them",
  "… read a local enum", "client: split children may use the own `this` of
  $name"
- Solid use: directives: hydrate-pages-solid "split children run a
  directive declared in the $where"
- module-level code the children use, a let they only assign:
  known-bugs-hydrate-module-level "client: an exported declaration the
  children use has one instance, initialized once", "client: split
  children reading Route $name use the one route", "client: $name that the
  children rely on reaches the chunk", "client: $name used by the children
  reaches the chunk"
- a hook in the boundary's own props: hydrate-boundary-forms "a hook call
  in the props of the boundary runs in the parent render, and the children
  still split"
- split={false}: hydrate-boundary-forms "$name with split={false} stays in
  place in both environments"
- the server strips fallbacks: hydrate-boundary-forms "server: $name is
  removed", hydrate-pages "$how shows, then the children"

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
History 2026-10-29 19:57:51 +01:00
.agents/skills improve bundle size benchmarks and add initial skill (#7450) 2026-06-04 22:48:53 +02:00
.changeset test(start-plugin-core): Start's router options follow one rule on Vite and Rsbuild 2026-10-29 19:28:26 +01:00
.devcontainer docs: add devcontainer config (#6970) 2026-03-18 15:10:30 +01:00
.github ci(compiler-platforms): install Chromium and the Start packages the compiler tiers need 2026-10-26 12:29:30 +01:00
.nx ci: upgrade Nx and migrate worker configuration (#8807) 2026-10-25 01:21:10 +02:00
_artifacts docs: use new query methods (#7100) 2026-10-06 17:59:20 +02:00
benchmarks docs: source, docs and test comments explain instead of citing ruling numbers 2026-10-29 18:16:24 +01:00
docs fix(import-protection): dev log: 'always' asks onViolation at every compile, cached plans included 2026-10-29 17:27:19 +01:00
e2e fix(start-plugin-core,router-plugin): position loader diagnostics as (file:line:col) like the Vite host 2026-10-26 13:18:57 +01:00
examples Merge Lane CI (Compiler Platforms setup, Windows links, plugin-order gate, library-build generateBundle, compiler-tier parallelism): t3/compiler-rewrite-ci-fixes 2026-10-26 14:58:36 +01:00
gpt chore: use tinyglobby instead of glob (#2880) 2024-11-28 21:28:27 +01:00
media docs: use the dynamic README header endpoint (#7940) 2026-08-03 21:03:29 +02:00
packages test(start-plugin-core): planner tests check names by shape, not by spelling 2026-10-29 19:57:51 +01:00
scripts bench(bundle-size): measure Start server output and server cold start 2026-10-25 12:29:02 +01:00
skills/bundle-size-optimization ci: keep bundle-size measurement out of the Test workflow (#8669) 2026-10-17 12:35:23 +02:00
.coderabbit.yaml docs: clarify contribution guidelines (#8163) 2026-08-25 05:14:16 +02:00
.gitattributes chore: better build system 2022-01-31 12:06:06 -07:00
.gitignore chore: drop unused devDependencies, the yuku release-age exclusion and a stale .gitignore entry 2026-10-26 09:24:57 +01:00
.npmrc ci: move pnpm settings to pnpm-workspace.yaml (#6076) 2025-12-12 15:25:17 +11:00
.nvmrc chore: update Node.js to 26.12.1 (#8779) 2026-10-21 19:28:23 +02:00
.prettierignore refactor(router-generator): one event classification, leaner tree model, imports under the header 2026-10-29 18:04:09 +01:00
AGENTS.md Merge origin/main into t3/yuku-compiler-rewrite 2026-10-25 22:56:24 +01:00
CONTRIBUTING.md docs(compiler): test tiers in AGENTS.md and CONTRIBUTING.md; point split suites at their other half 2026-10-18 19:13:10 +02:00
DEBUGGING.md feat: optional path params (#4597) 2025-07-16 13:41:58 -06:00
eslint.config.js test: migrate lint from tanstack/config to tanstack/eslint-config (#6915) 2026-03-13 03:02:00 +01:00
how-to-guides-implementation-plan.md docs: search param sharing/inheritance how-to 2025-07-30 11:09:18 -06:00
how-to-testing-plan.md ci: apply automated fixes 2025-07-28 19:18:28 +00:00
knip.json chore: Migrate to ESLint flat config (#1846) 2024-06-28 11:59:39 +10:00
labeler-config.yml chore: remove experimental Nitro v2 Vite plugin (#8537) 2026-10-13 00:42:07 +02:00
LICENSE Update outdated LICENSE year (#335) 2022-11-10 08:49:28 -07:00
nx.json Merge origin/main into t3/yuku-compiler-rewrite 2026-10-25 22:56:24 +01:00
package.json Merge origin/main into t3/yuku-compiler-rewrite 2026-10-25 22:56:24 +01:00
pnpm-lock.yaml chore(router-utils): bump yuku to 0.26.0 2026-10-29 14:15:55 +01:00
pnpm-workspace.yaml chore(router-utils): bump yuku to 0.26.0 2026-10-29 14:15:55 +01:00
prettier.config.js ci: enable renovate automerge, pin actions (#2012) 2024-07-23 11:13:39 +10:00
README.md docs: use the dynamic README header endpoint (#7940) 2026-08-03 21:03:29 +02:00
top-10-how-to-guides.md docs: Identify top 10 how-to docs, add deployment guide (#4701) 2025-07-18 15:15:07 -06:00
tsconfig.json optimize streaming (#8204) 2026-09-16 22:38:25 +02:00

TanStack Router

TanStack Router

A modern router designed for type safety, data‑driven navigation, and seamless developer experience.

  • End‑to-end type safety (routes, params, loaders)
  • Schema‑driven search params with validation
  • Built‑in caching, prefetching & invalidation
  • Nested layouts, transitions & error boundaries

Read the Router Docs →

TanStack Start

TanStack Start

A full‑stack framework built on Router, designed for server rendering, streaming, and production‑ready deployments.

  • Full‑document SSR & streaming
  • Server functions & end‑to‑end type safety
  • Deployment‑ready bundling & builds
  • All the power of TanStack Router, plus full‑stack features

Read the Start Docs →


npm downloads GitHub stars Bundle size

semantic-release Best of JS Follow @TanStack

Get Involved

Partners

CodeRabbit Cloudflare Netlify
Neon Clerk Convex
Sentry Prisma Strapi
Router & you?

We're looking for TanStack Router & Start Partners to join our mission! Partner with us to push the boundaries of TanStack Router & Start and build amazing things together.

LET'S CHAT

Explore the TanStack Ecosystem

… and more at TanStack.com »