How tanstack/router works
TanStack Router provides typed, data-driven routing across React, Solid, and Vue; TanStack Start builds a full-stack SSR and streaming framework on top. The main workflow is application navigation through route matching and data loading into framework UI, or an incoming server request through Start’s handler to rendered/streamed output and client hydration. The README documents the product capabilities; source-index references establish only the specific internal links cited below. Several subsystems are represented by their exact tree paths but were not sampled, so uncertain internal links are omitted.
Main entry points: router.ts Router engine · createStartHandler.ts Request handler · generator.ts Route generator · route.ts Route definitions
Components 18
Routing runtime
- Router engine
packages/router-core/src/router.ts - Route definitions
packages/router-core/src/route.ts - Route tree
packages/router-core/src/new-process-route-tree.ts - Route loading
packages/router-core/src/load-client.ts - Match rendering
packages/router-core/src/Matches.ts
UI adapters
- React adapter
packages/react-router/src/useRouterState.tsx - Solid adapter
packages/solid-router/src/useRouterState.tsx - Vue adapter
packages/vue-router/src/useRouterState.tsx
Start runtime
- Request handler
packages/start-server-core/src/createStartHandler.ts - Server rendering
packages/react-start-server/src/StartServer.tsx - Client hydration
packages/react-start-client/src/StartClient.tsx - Server functions
packages/start-server-core/src/server-functions-handler.ts - RSC streaming
packages/react-start-rsc/src/createServerComponentFromStream.ts
Generation and diagnostics
- Route generator
packages/router-generator/src/generator.ts - Build integrations
packages/router-plugin/src/core/router-generator-plugin.ts - Router devtools
packages/router-devtools-core/src/TanStackRouterDevtoolsCore.tsx
Other components
- App developer
- Rendered response
Connections 19
- App developer → Route definitions: defines routes
README.md - Route definitions → Router engine: configures
packages/router-core/src/route.ts - Router engine → Route tree: processes tree
packages/router-core/src/router.ts - Router engine → Route loading: loads routes
packages/router-core/src/router.ts - Router engine → Match rendering: provides matches
packages/router-core/src/Matches.ts - React adapter → Router engine: reads state
packages/react-router/src/useRouterState.tsx - Solid adapter → Router engine: reads state
packages/solid-router/src/useRouterState.tsx - Vue adapter → Router engine: reads state
packages/vue-router/src/useRouterState.tsx - App developer → Route generator: supplies routes
- Route generator → Route tree: generates tree
- Build integrations → Route generator: integrates generator
- Router devtools → Router engine: inspects state
- App developer → Request handler: deploys app
- Request handler → Router engine: routes request
packages/start-server-core/src/createStartHandler.ts - Request handler → Server functions: dispatches functions
packages/start-server-core/src/createStartHandler.ts - Request handler → Server rendering: renders response
- Server rendering → Rendered response: streams HTML
- Request handler → RSC streaming: supports RSC
- Rendered response → Client hydration: hydrates