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 b8d7cbc361
test(router-plugin): the real router packages in the Vite dev-server harness
`routerPackageStub` (a fake `@tanstack/{react,solid,vue}-router` with an
invented `.load()`) and `loadRouteOption` are gone (split F03): the
apps resolve the real built router packages, dependencies of this
package. New helpers of tests/dev-server.ts:

- `renderRoutePath(server, pathname)`: the real router over the generated
  tree, `router.load()`, `<RouterProvider>` to HTML (SSR environment).
- `renderRouteComponent(component)`: React renders a component option
  (after the real `preload()` when split).
- `servedRouterPackageUrl(server, target)`: the URL the client
  environment serves the router package at (Vite's own resolver), the key
  of its stub for `evaluateServed`.
- `importRouteModule` returns `{ server, routeModule }`.

`expectExportedRouteOptions` asserts outcomes: the export exists and is a
component; a split option is the real router's lazy component of it
(`preload`) rendering the same HTML; the page renders through the real
router. The pins that use it (known-bugs-dev-server: class and aliased
exports lost, shared overloads) fail without `.fails` on the missing
export (checked). `expectSharedOverloads` calls the real options.

Consumers (minimal edits in other owners' files): plugin-options.test.ts
(PO), router-plugin-context.test.ts (CTX), route-hmr.test.ts (W2-g:
Solid cases get `vite-plugin-solid` with `ssr: true`, which a Solid app's
SSR environment needs for the router's Solid build; the client evaluation
stubs the router with the SSR-loaded real package), dev-server-new-routes
(W2-f) and vite-hot-update.ts (W2-g deletes it): the router is served
from `/@fs/`, so the page-load skip patterns include it.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
History 2026-10-18 20:37:50 +02:00
.agents/skills improve bundle size benchmarks and add initial skill (#7450) 2026-06-04 22:48:53 +02:00
.changeset refactor(router-plugin): remove enableRouteGeneration option (#8737) 2026-10-17 12:22:15 +02:00
.devcontainer docs: add devcontainer config (#6970) 2026-03-18 15:10:30 +01:00
.github ci(compiler-platforms): fast tier plus a browser-free integration smoke set 2026-10-18 19:13:10 +02:00
.nx/workflows test: fix Nx sandbox violations in CI tasks (#8400) 2026-09-14 10:54:23 +02:00
_artifacts docs: use new query methods (#7100) 2026-10-06 17:59:20 +02:00
benchmarks bump node version to 26.10.0 (#8509) 2026-10-17 17:04:18 +02:00
docs perf: lower manifest script preload priority (#8212) 2026-10-16 15:35:33 +02:00
e2e build: one sass in the workspace so every package resolves the same vite 2026-10-18 18:00:16 +02:00
examples ci: Version Packages (#8733) 2026-10-16 23:05:28 +02: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(router-plugin): the real router packages in the Vite dev-server harness 2026-10-18 20:37:50 +02:00
scripts ci: keep bundle-size measurement out of the Test workflow (#8669) 2026-10-17 12:35:23 +02: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: update nx to 23.2.0 (#8341) 2026-09-10 18:28:24 +02:00
.npmrc ci: move pnpm settings to pnpm-workspace.yaml (#6076) 2025-12-12 15:25:17 +11:00
.nvmrc bump node version to 26.10.0 (#8509) 2026-10-17 17:04:18 +02:00
.prettierignore fix: harden URL handling across Router and Start (#8308) 2026-09-09 23:03:49 +02:00
AGENTS.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
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 test(compiler): fast and slow test tiers 2026-10-18 19:01:04 +02:00
package.json test(compiler): fast and slow test tiers 2026-10-18 19:01:04 +02:00
pnpm-lock.yaml build: one sass in the workspace so every package resolves the same vite 2026-10-18 18:00:16 +02:00
pnpm-workspace.yaml chore(deps): upgrade Vitest to 5 and migrate benchmarks to the bench fixture (#8723) 2026-10-16 00:41:32 +02: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 »