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 abc50176da
refactor(router-plugin): one router planner, configured by one builder
`route-split` and `route-hmr` were one planner presented as two: they
shared one config object under two names, recorded the route-registry
fingerprint twice, read each other's prefetch and passed state through
WeakMaps keyed by the round's rewrite set (`round.ts`, the split plan and
recognition memos). They are now one `router` planner: one config entry,
one prefetch, one gate (`split || deleteNodes || hmr`), and per planning
round one recognition and one decision table (`RouterRound`) read by the
HMR hoists, the split part and the HMR block, in that order, inside its
`plan`. The planner no longer uses the core's `prepare` phase.

`routerPlannerConfigFrom(codeSplittingOptions, env)` builds the
configuration of one environment for every host (RouterCompiler and both
Start hosts), with `routerPlannerConfigDigest` for the config key and
`routerPlannerApplies` for the gate. The config's `hmr` is null outside a
development client, so the "route HMR is on" decision is the builder's;
`routeRefreshMarkers` derives the React refresh-marker decision from it
for the split chunks and Start's Hydrate chunks. Start's rules are one
rule on both bundlers, as Start on Vite on main: the client always has
route HMR (Start on Rsbuild honoured `addHmr: false`, new in this PR) and
erases `ssr`/`server`/`headers`; server environments erase the user's
`deleteNodes` (Start on Rsbuild dropped them, as on main).

Outputs are byte-identical to the previous head on the in-process corpus
(338 route modules: Start dev/build, router-only dev with and without
splitting and build, React and Solid, client and ssr).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
History 2026-10-29 19:24:13 +01:00
.agents/skills improve bundle size benchmarks and add initial skill (#7450) 2026-06-04 22:48:53 +02:00
.changeset refactor(router-plugin)!: derive the route HMR style from the host; remove plugin.hmr.style 2026-10-29 17:40:56 +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 refactor(router-plugin): one router planner, configured by one builder 2026-10-29 19:24:13 +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 »