# tanstack/router architecture

> Architecture diagram of the GitHub repository tanstack/router, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tanstack/router
- Repository: https://github.com/tanstack/router
- Video tour (about a minute): https://gitdiagram.com/tanstack/router/video

## Overview

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: [`packages/router-core/src/router.ts`](https://github.com/tanstack/router/blob/main/packages/router-core/src/router.ts) (Router engine), [`packages/start-server-core/src/createStartHandler.ts`](https://github.com/tanstack/router/blob/main/packages/start-server-core/src/createStartHandler.ts) (Request handler), [`packages/router-generator/src/generator.ts`](https://github.com/tanstack/router/blob/main/packages/router-generator/src/generator.ts) (Route generator), [`packages/router-core/src/route.ts`](https://github.com/tanstack/router/blob/main/packages/router-core/src/route.ts) (Route definitions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Routing runtime"]
  node_router["Router engine<br/>[router.ts]"]
  node_routes["Route definitions<br/>[route.ts]"]
  node_route_tree["Route tree"]
  node_route_loading["Route loading<br/>[load-client.ts]"]
  node_matching["Match rendering<br/>[Matches.ts]"]
end

subgraph group_frameworks["UI adapters"]
  node_react["React adapter<br/>[useRouterState.tsx]"]
  node_solid["Solid adapter<br/>[useRouterState.tsx]"]
  node_vue["Vue adapter<br/>[useRouterState.tsx]"]
end

subgraph group_start["Start runtime"]
  node_start_handler["Request handler"]
  node_start_server["Server rendering<br/>[StartServer.tsx]"]
  node_start_client["Client hydration<br/>[StartClient.tsx]"]
  node_server_functions["Server functions"]
  node_rsc["RSC streaming"]
end

subgraph group_tooling["Generation and diagnostics"]
  node_generator["Route generator<br/>[generator.ts]"]
  node_router_plugin["Build integrations"]
  node_devtools["Router devtools"]
end

node_developer(("App developer"))
node_response["Rendered response"]

node_developer -->|"defines routes"| node_routes
node_routes -->|"configures"| node_router
node_router -->|"processes tree"| node_route_tree
node_router -->|"loads routes"| node_route_loading
node_router -->|"provides matches"| node_matching
node_react -->|"reads state"| node_router
node_solid -->|"reads state"| node_router
node_vue -->|"reads state"| node_router
node_developer -.->|"supplies routes"| node_generator
node_generator -.->|"generates tree"| node_route_tree
node_router_plugin -->|"integrates generator"| node_generator
node_devtools -.->|"inspects state"| node_router
node_developer -.->|"deploys app"| node_start_handler
node_start_handler -->|"routes request"| node_router
node_start_handler -->|"dispatches functions"| node_server_functions
node_start_handler -.->|"renders response"| node_start_server
node_start_server -.->|"streams HTML"| node_response
node_start_handler -.->|"supports RSC"| node_rsc
node_response -.->|"hydrates"| node_start_client

click node_router "https://github.com/tanstack/router/blob/main/packages/router-core/src/router.ts"
click node_routes "https://github.com/tanstack/router/blob/main/packages/router-core/src/route.ts"
click node_route_tree "https://github.com/tanstack/router/blob/main/packages/router-core/src/new-process-route-tree.ts"
click node_route_loading "https://github.com/tanstack/router/blob/main/packages/router-core/src/load-client.ts"
click node_matching "https://github.com/tanstack/router/blob/main/packages/router-core/src/Matches.ts"
click node_react "https://github.com/tanstack/router/blob/main/packages/react-router/src/useRouterState.tsx"
click node_solid "https://github.com/tanstack/router/blob/main/packages/solid-router/src/useRouterState.tsx"
click node_vue "https://github.com/tanstack/router/blob/main/packages/vue-router/src/useRouterState.tsx"
click node_generator "https://github.com/tanstack/router/blob/main/packages/router-generator/src/generator.ts"
click node_router_plugin "https://github.com/tanstack/router/blob/main/packages/router-plugin/src/core/router-generator-plugin.ts"
click node_devtools "https://github.com/tanstack/router/blob/main/packages/router-devtools-core/src/TanStackRouterDevtoolsCore.tsx"
click node_start_handler "https://github.com/tanstack/router/blob/main/packages/start-server-core/src/createStartHandler.ts"
click node_start_server "https://github.com/tanstack/router/blob/main/packages/react-start-server/src/StartServer.tsx"
click node_start_client "https://github.com/tanstack/router/blob/main/packages/react-start-client/src/StartClient.tsx"
click node_server_functions "https://github.com/tanstack/router/blob/main/packages/start-server-core/src/server-functions-handler.ts"
click node_rsc "https://github.com/tanstack/router/blob/main/packages/react-start-rsc/src/createServerComponentFromStream.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_router,node_routes,node_route_tree,node_route_loading,node_matching toneBlue
class node_react,node_solid,node_vue toneAmber
class node_start_handler,node_start_server,node_start_client,node_server_functions,node_rsc toneMint
class node_generator,node_router_plugin,node_devtools toneRose
class node_developer,node_response toneIndigo
```

## Components

### Routing runtime

- [Router engine](https://github.com/tanstack/router/blob/main/packages/router-core/src/router.ts): `packages/router-core/src/router.ts`
- [Route definitions](https://github.com/tanstack/router/blob/main/packages/router-core/src/route.ts): `packages/router-core/src/route.ts`
- [Route tree](https://github.com/tanstack/router/blob/main/packages/router-core/src/new-process-route-tree.ts): `packages/router-core/src/new-process-route-tree.ts`
- [Route loading](https://github.com/tanstack/router/blob/main/packages/router-core/src/load-client.ts): `packages/router-core/src/load-client.ts`
- [Match rendering](https://github.com/tanstack/router/blob/main/packages/router-core/src/Matches.ts): `packages/router-core/src/Matches.ts`

### UI adapters

- [React adapter](https://github.com/tanstack/router/blob/main/packages/react-router/src/useRouterState.tsx): `packages/react-router/src/useRouterState.tsx`
- [Solid adapter](https://github.com/tanstack/router/blob/main/packages/solid-router/src/useRouterState.tsx): `packages/solid-router/src/useRouterState.tsx`
- [Vue adapter](https://github.com/tanstack/router/blob/main/packages/vue-router/src/useRouterState.tsx): `packages/vue-router/src/useRouterState.tsx`

### Start runtime

- [Request handler](https://github.com/tanstack/router/blob/main/packages/start-server-core/src/createStartHandler.ts): `packages/start-server-core/src/createStartHandler.ts`
- [Server rendering](https://github.com/tanstack/router/blob/main/packages/react-start-server/src/StartServer.tsx): `packages/react-start-server/src/StartServer.tsx`
- [Client hydration](https://github.com/tanstack/router/blob/main/packages/react-start-client/src/StartClient.tsx): `packages/react-start-client/src/StartClient.tsx`
- [Server functions](https://github.com/tanstack/router/blob/main/packages/start-server-core/src/server-functions-handler.ts): `packages/start-server-core/src/server-functions-handler.ts`
- [RSC streaming](https://github.com/tanstack/router/blob/main/packages/react-start-rsc/src/createServerComponentFromStream.ts): `packages/react-start-rsc/src/createServerComponentFromStream.ts`

### Generation and diagnostics

- [Route generator](https://github.com/tanstack/router/blob/main/packages/router-generator/src/generator.ts): `packages/router-generator/src/generator.ts`
- [Build integrations](https://github.com/tanstack/router/blob/main/packages/router-plugin/src/core/router-generator-plugin.ts): `packages/router-plugin/src/core/router-generator-plugin.ts`
- [Router devtools](https://github.com/tanstack/router/blob/main/packages/router-devtools-core/src/TanStackRouterDevtoolsCore.tsx): `packages/router-devtools-core/src/TanStackRouterDevtoolsCore.tsx`

### Other components

- **App developer**
- **Rendered response**

## Connections

- App developer → Route definitions: defines routes (evidence: `README.md`)
- Route definitions → Router engine: configures (evidence: `packages/router-core/src/route.ts`)
- Router engine → Route tree: processes tree (evidence: `packages/router-core/src/router.ts`)
- Router engine → Route loading: loads routes (evidence: `packages/router-core/src/router.ts`)
- Router engine → Match rendering: provides matches (evidence: `packages/router-core/src/Matches.ts`)
- React adapter → Router engine: reads state (evidence: `packages/react-router/src/useRouterState.tsx`)
- Solid adapter → Router engine: reads state (evidence: `packages/solid-router/src/useRouterState.tsx`)
- Vue adapter → Router engine: reads state (evidence: `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 (evidence: `packages/start-server-core/src/createStartHandler.ts`)
- Request handler → Server functions: dispatches functions (evidence: `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
