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 9945237b91
refactor(router-utils): the renderer is the walk of the region tree (design 1, step 2)
One walk per output (`OutputView.walk`) renders source text: a node renders
its place (a kept claim's placeholder, or the edit replacing it) or its text
(its edit's body, or its source with the nodes inside it); a node rendering
as its source is walked through; an insert belongs to the innermost node
strictly holding its position. The renderer (freeze), placement's reads and
the erased parts are its visitors; liveness climbs the tree with the same
text/place rules.

- Owners render their claimed region whole (`{ k: 'region', id }`); a
  generated unit names no slice. Route options written as methods claim the
  function and edit the property to `key: ` plus it (router split and HMR).
- A slice that cuts a node rewritten in the output, or that leaves the text
  its edit rewrites, is a conflict in every mode (F2-1's keep-slice cases).
- `claim()` registers its node (a claim on a unit region too) and rejects a
  second claim on one range (review of step 1, findings 1 and 2).
- Placement's region nesting is read on the tree (`parentOf`, `childrenOf`,
  `innermostAt`); `Region.parent`/`children` are gone.
- Deleted: `RenderTree`, `TreeEdit`, `tree()`, `topLevelWithin`, the copy
  guard (`editUnderCopy`, R127, and its error-severity diagnostics), the
  `exclude` lookup, verify (c), `regionReads`' edit scan, `fragReads`,
  `editRenders`, `placeholderRenders`, `overrideOf`, `decide`'s bound, the
  erased parts' `topLevelWithin` emulation and `anyHidden`.
- Scaling: the statement-start guard indexes one top-level statement per
  walk instead of walking the module per offset, and `isErasedRange` visits
  only the nodes overlapping its range (a module of 1,600 hoisted server
  functions compiled in 8.5 to 10 times one of 400; now about 4 times).
- Tests: the random trees register in shuffled order, check the derived
  output and ranges, and claim kept slices (the shape step 1 left out now
  holds); the scaling test hoists every handler; the copy-guard tests and
  the erased-parts emulation test go with their mechanisms.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
History 2026-11-10 21:19:34 +01:00
.agents/skills improve bundle size benchmarks and add initial skill (#7450) 2026-06-04 22:48:53 +02:00
.changeset refactor(router-utils): the renderer is the walk of the region tree (design 1, step 2) 2026-11-10 21:19:34 +01:00
.devcontainer docs: add devcontainer config (#6970) 2026-03-18 15:10:30 +01:00
.github ci: run the e2e compiles with the compiler's self-checks on 2026-11-09 20:10:56 +01:00
.nx ci: run the e2e compiles with the compiler's self-checks on 2026-11-09 20:10:56 +01:00
_artifacts docs: use new query methods (#7100) 2026-10-06 17:59:20 +02:00
benchmarks Merge origin/main into compiler-rewrite/yuku 2026-11-08 12:12:53 +01:00
docs docs(start): a second argument to .handler() is outside what the compiler follows 2026-11-10 16:06:29 +01:00
e2e ci: run the e2e compiles with the compiler's self-checks on 2026-11-09 20:10:56 +01:00
examples chore(examples): ignore .tanstack/ in every Start example 2026-11-09 15:00:55 +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-utils): the renderer is the walk of the region tree (design 1, step 2) 2026-11-10 21:19:34 +01:00
scripts ci: run the e2e compiles with the compiler's self-checks on 2026-11-09 20:10:56 +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 ci: run the e2e compiles with the compiler's self-checks on 2026-11-09 20:10:56 +01:00
package.json fix(start-plugin-core): pass Start's router options through to the generator and code splitter (#8861) 2026-11-03 21:39:54 +01:00
pnpm-lock.yaml fix(router-utils): compose an earlier loader's index map (R3-G7-6) 2026-11-10 01:09:05 +01:00
pnpm-workspace.yaml chore: drop the yuku release-age exemption 2026-11-08 18:53:50 +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 »