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
framework
fullstack
javascript
react
route
router
routing
rpc
search
searchparams
server-functions
ssr
state-management
typesafe
typescript
url
- TypeScript 98.2%
- JavaScript 1.2%
- CSS 0.4%
- Vue 0.1%
- HTML 0.1%
route-tree.ts:
- The app's Vite config is read from its sources: @vitejs/plugin-vue for
.vue files, vite-plugin-solid ({ ssr: true }) when modules import Solid;
Solid apps let the plugin bundle the Solid router's sources for the
server (otherwise Node loads the packages).
- Solid apps share one Vite server per worker (compiling the Solid router's
sources takes ~0.7 s); before each load it forgets every module of the
app, so edited or regenerated files are transformed again. React and Vue
apps keep a fresh server per load.
- The router package is the loaded entry module (react/solid/vue-router
dist index) the app's modules use; pages render with react-dom/server,
solid-js/web (as the router package loaded it) or vue/server-renderer.
Tests:
- The Solid rows of generator-options.test.ts and template.test.ts load
their trees again (guards removed).
- real-router.test.ts is split: route shapes and pins stay there; React,
Solid and Vue page apps move to real-router-frameworks.test.ts; shared
helpers to real-router.ts. New React and Solid apps render their pages
(root layout, index, lazy component, lazy-only route, child route,
pathless layout); the Solid app's types are checked too.
- Route group layout (`(marketing)/route.tsx`): the runtime half (ids,
parents, matching, rendering) is a passing test; only the types mismatch
stays pinned. The pin now cites the docs (file-naming-conventions.md:15
`(folder)` route groups, :18 `route.tsx`) and #4629, which made it a
maintained shape.
- Lazy-only pathless layout (`settings/_layout.lazy.tsx`): restored as a
`.fails` pin with matching, rendering and types (types already say
/settings/profile; the router gives /profile). Lazy-only route files are
documented (guide/code-splitting.md:222-224, SPEC J1.8); same bug as the
G1 pin in route-paths.test.ts. Verified red without `.fails`.
All 21 router-generator pins re-run without `.fails`: red for their
stated reasons.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
History
|
|
|---|---|---|
| .agents/skills | ||
| .changeset | ||
| .devcontainer | ||
| .github | ||
| .nx/workflows | ||
| _artifacts | ||
| benchmarks | ||
| docs | ||
| e2e | ||
| examples | ||
| gpt | ||
| media | ||
| packages | ||
| scripts | ||
| skills/bundle-size-optimization | ||
| .coderabbit.yaml | ||
| .gitattributes | ||
| .gitignore | ||
| .npmrc | ||
| .nvmrc | ||
| .prettierignore | ||
| AGENTS.md | ||
| CONTRIBUTING.md | ||
| DEBUGGING.md | ||
| eslint.config.js | ||
| how-to-guides-implementation-plan.md | ||
| how-to-testing-plan.md | ||
| knip.json | ||
| labeler-config.yml | ||
| LICENSE | ||
| nx.json | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| prettier.config.js | ||
| README.md | ||
| top-10-how-to-guides.md | ||
| tsconfig.json | ||
TanStack RouterA modern router designed for type safety, data‑driven navigation, and seamless developer experience.
Read the Router Docs → |
TanStack StartA full‑stack framework built on Router, designed for server rendering, streaming, and production‑ready deployments.
Read the Start Docs → |
Get Involved
- We welcome issues and pull requests!
- Participate in GitHub discussions
- Chat with the community on Discord
- See CONTRIBUTING.md for setup instructions
Partners
|
|
|
|
|
|
|
|
|
|
|
|
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 CHATExplore the TanStack Ecosystem
- TanStack Config – Tooling for JS/TS packages
- TanStack DB – Reactive sync client store
- TanStack DevTools – Unified devtools panel
- TanStack Form – Type‑safe form state
- TanStack Pacer – Debouncing, throttling, batching
- TanStack Query – Async state & caching
- TanStack Ranger – Range & slider primitives
- TanStack Store – Reactive data store
- TanStack Table – Headless datagrids
- TanStack Virtual – Virtualized rendering
… and more at TanStack.com »