# remix-run/react-router architecture

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

- Interactive diagram: https://gitdiagram.com/remix-run/react-router
- Repository: https://github.com/remix-run/react-router

## Overview

React Router is a multi-strategy React routing product, usable as a library or as a full-stack framework. In the central runtime workflow, a user initiates navigation, router APIs and hooks coordinate routing, and framework route modules supply rendering and data behavior. Framework capabilities also include route configuration, development tooling, server adapters, and project creation. The graph emphasizes the core and documented package boundaries; some internal runtime connections are supported only by the source index, so unsampled implementation details are not expanded.

Main entry points: [`packages/react-router/lib/dom/ssr/entry.ts`](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/entry.ts) (SSR entry context), [`packages/react-router/lib/hooks.tsx`](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/hooks.tsx) (Navigation hooks), [`packages/react-router/lib/dom/ssr/routes.tsx`](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/routes.tsx) (Framework routes), [`packages/react-router/lib/router/router.ts`](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/router/router.ts) (Navigation engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Router runtime"]
  node_core_api["Router APIs<br/>[components.tsx]"]
  node_hooks["Navigation hooks<br/>[hooks.tsx]"]
  node_router["Navigation engine<br/>[router.ts]"]
  node_history["History management<br/>[history.ts]"]
end

subgraph group_framework["Framework rendering"]
  node_framework_routes["Framework routes<br/>[routes.tsx]"]
  node_route_modules["Route modules<br/>[routeModules.ts]"]
  node_ssr_entry["SSR entry context<br/>[entry.ts]"]
  node_route_discovery["Route discovery<br/>[route-discovery.ts]"]
  node_server_build["Server build data<br/>[build.ts]"]
end

subgraph group_configuration["Route configuration"]
  node_route_config["Route config<br/>[routes.ts]"]
  node_fs_routes["Filesystem routes<br/>[flatRoutes.ts]"]
  node_dev_vite["Vite tooling<br/>[plugin.ts]"]
end

subgraph group_platform["Server platforms"]
  node_node_adapter["Node adapter<br/>[server.ts]"]
  node_express_adapter["Express adapter<br/>[server.ts]"]
  node_cloudflare_adapter["Cloudflare adapter<br/>[worker.ts]"]
  node_serve["Web server<br/>[cli.ts]"]
end

subgraph group_creation["Project setup"]
  node_create_cli["Project creation<br/>[cli.ts]"]
end

node_user(("App user"))

node_user -->|"uses routing"| node_core_api
node_core_api -->|"exposes hooks"| node_hooks
node_hooks -->|"uses engine"| node_router
node_hooks -->|"uses history"| node_history
node_ssr_entry -->|"uses discovery"| node_route_discovery
node_ssr_entry -->|"uses router"| node_router
node_ssr_entry -->|"uses routes"| node_framework_routes
node_ssr_entry -->|"uses modules"| node_route_modules
node_ssr_entry -->|"uses build data"| node_server_build
node_framework_routes -->|"loads modules"| node_route_modules
node_framework_routes -->|"uses matching"| node_router
node_route_config -.->|"configures framework"| node_dev_vite
node_fs_routes -.->|"supplies routes"| node_route_config
node_user -->|"creates project"| node_create_cli
node_user -->|"uses adapter"| node_node_adapter
node_user -->|"uses adapter"| node_express_adapter
node_user -->|"uses adapter"| node_cloudflare_adapter
node_user -->|"uses server"| node_serve

click node_core_api "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/components.tsx"
click node_hooks "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/hooks.tsx"
click node_router "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/router/router.ts"
click node_history "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/router/history.ts"
click node_framework_routes "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/routes.tsx"
click node_route_modules "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/routeModules.ts"
click node_ssr_entry "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/entry.ts"
click node_route_discovery "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/route-discovery.ts"
click node_server_build "https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/server-runtime/build.ts"
click node_route_config "https://github.com/remix-run/react-router/blob/main/packages/react-router-dev/config/routes.ts"
click node_fs_routes "https://github.com/remix-run/react-router/blob/main/packages/react-router-fs-routes/flatRoutes.ts"
click node_dev_vite "https://github.com/remix-run/react-router/blob/main/packages/react-router-dev/vite/plugin.ts"
click node_node_adapter "https://github.com/remix-run/react-router/blob/main/packages/react-router-node/server.ts"
click node_express_adapter "https://github.com/remix-run/react-router/blob/main/packages/react-router-express/server.ts"
click node_cloudflare_adapter "https://github.com/remix-run/react-router/blob/main/packages/react-router-cloudflare/worker.ts"
click node_serve "https://github.com/remix-run/react-router/blob/main/packages/react-router-serve/cli.ts"
click node_create_cli "https://github.com/remix-run/react-router/blob/main/packages/create-react-router/cli.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_core_api,node_hooks,node_router,node_history,node_user toneBlue
class node_framework_routes,node_route_modules,node_ssr_entry,node_route_discovery,node_server_build toneAmber
class node_route_config,node_fs_routes,node_dev_vite toneMint
class node_node_adapter,node_express_adapter,node_cloudflare_adapter,node_serve toneRose
class node_create_cli toneIndigo
```

## Components

### Router runtime

- [Router APIs](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/components.tsx): `packages/react-router/lib/components.tsx`
- [Navigation hooks](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/hooks.tsx): `packages/react-router/lib/hooks.tsx`
- [Navigation engine](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/router/router.ts): `packages/react-router/lib/router/router.ts`
- [History management](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/router/history.ts): `packages/react-router/lib/router/history.ts`

### Framework rendering

- [Framework routes](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/routes.tsx): `packages/react-router/lib/dom/ssr/routes.tsx`
- [Route modules](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/routeModules.ts): `packages/react-router/lib/dom/ssr/routeModules.ts`
- [SSR entry context](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/entry.ts): `packages/react-router/lib/dom/ssr/entry.ts`
- [Route discovery](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/dom/ssr/route-discovery.ts): `packages/react-router/lib/dom/ssr/route-discovery.ts`
- [Server build data](https://github.com/remix-run/react-router/blob/main/packages/react-router/lib/server-runtime/build.ts): `packages/react-router/lib/server-runtime/build.ts`

### Route configuration

- [Route config](https://github.com/remix-run/react-router/blob/main/packages/react-router-dev/config/routes.ts): `packages/react-router-dev/config/routes.ts`
- [Filesystem routes](https://github.com/remix-run/react-router/blob/main/packages/react-router-fs-routes/flatRoutes.ts): `packages/react-router-fs-routes/flatRoutes.ts`
- [Vite tooling](https://github.com/remix-run/react-router/blob/main/packages/react-router-dev/vite/plugin.ts): `packages/react-router-dev/vite/plugin.ts`

### Server platforms

- [Node adapter](https://github.com/remix-run/react-router/blob/main/packages/react-router-node/server.ts): `packages/react-router-node/server.ts`
- [Express adapter](https://github.com/remix-run/react-router/blob/main/packages/react-router-express/server.ts): `packages/react-router-express/server.ts`
- [Cloudflare adapter](https://github.com/remix-run/react-router/blob/main/packages/react-router-cloudflare/worker.ts): `packages/react-router-cloudflare/worker.ts`
- [Web server](https://github.com/remix-run/react-router/blob/main/packages/react-router-serve/cli.ts): `packages/react-router-serve/cli.ts`

### Project setup

- [Project creation](https://github.com/remix-run/react-router/blob/main/packages/create-react-router/cli.ts): `packages/create-react-router/cli.ts`

### Other components

- **App user**

## Connections

- App user → Router APIs: uses routing (evidence: `README.md`)
- Router APIs → Navigation hooks: exposes hooks (evidence: `packages/react-router/lib/hooks.tsx`)
- Navigation hooks → Navigation engine: uses engine (evidence: `packages/react-router/lib/hooks.tsx`)
- Navigation hooks → History management: uses history (evidence: `packages/react-router/lib/hooks.tsx`)
- SSR entry context → Route discovery: uses discovery (evidence: `packages/react-router/lib/dom/ssr/entry.ts`)
- SSR entry context → Navigation engine: uses router (evidence: `packages/react-router/lib/dom/ssr/entry.ts`)
- SSR entry context → Framework routes: uses routes (evidence: `packages/react-router/lib/dom/ssr/entry.ts`)
- SSR entry context → Route modules: uses modules (evidence: `packages/react-router/lib/dom/ssr/entry.ts`)
- SSR entry context → Server build data: uses build data (evidence: `packages/react-router/lib/dom/ssr/entry.ts`)
- Framework routes → Route modules: loads modules (evidence: `packages/react-router/lib/dom/ssr/routes.tsx`)
- Framework routes → Navigation engine: uses matching (evidence: `packages/react-router/lib/dom/ssr/routes.tsx`)
- Route config → Vite tooling: configures framework
- Filesystem routes → Route config: supplies routes
- App user → Project creation: creates project (evidence: `README.md`)
- App user → Node adapter: uses adapter (evidence: `README.md`)
- App user → Express adapter: uses adapter (evidence: `README.md`)
- App user → Cloudflare adapter: uses adapter (evidence: `README.md`)
- App user → Web server: uses server (evidence: `README.md`)
