# facebook/react architecture

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

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

## Overview

React is a JavaScript UI library: application code describes component trees, and React renders and updates them for browser or server environments. This repository also contains a React Compiler and React Server Components (Flight) implementations, plus DevTools. The graph groups those product areas and highlights the compiler’s documented lowering and analysis stages. Source excerpts are limited, so several runtime relationships and the compiler’s later stages are represented as unverified rather than asserted as direct calls.

Main entry points: [`compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`](https://github.com/facebook/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts) (Babel Compiler Plugin), [`packages/react/src/ReactClient.js`](https://github.com/facebook/react/blob/main/packages/react/src/ReactClient.js) (React APIs), [`packages/react-reconciler/src`](https://github.com/facebook/react/tree/main/packages/react-reconciler/src) (Reconciler), [`packages/react-dom/src/client/ReactDOMClientFB.js`](https://github.com/facebook/react/blob/main/packages/react-dom/src/client/ReactDOMClientFB.js) (DOM Renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["React UI Runtime"]
  node_react["React APIs<br/>[ReactClient.js]"]
  node_reconciler["Reconciler"]
  node_dom["DOM Renderer"]
  node_syncstore["External Store Hook"]
end

subgraph group_server["Server Rendering and Flight"]
  node_domserver["Server Renderer<br/>[server.bun.js]"]
  node_flightserver["Flight Servers"]
  node_flightclient["Flight Client"]
  node_flightreply["Flight Replies"]
end

subgraph group_compiler["React Compiler"]
  node_compilerplugin["Babel Compiler Plugin<br/>[Pipeline.ts]"]
  node_environment["Compiler Environment<br/>[Environment.ts]"]
  node_hir["HIR Construction<br/>[BuildHIR.ts]"]
  node_analysis["Inference and Validation"]
  node_reactive["Reactive Scopes"]
  node_rustpipeline["Rust Compiler Pipeline<br/>[pipeline.rs]"]
  node_compilerresult["Compiler Results<br/>[compile_result.rs]"]
end

subgraph group_devtools["React DevTools"]
  node_devtools["DevTools<br/>[app.js]"]
  node_devtoolsbackground["Extension Background<br/>[tabsManager.js]"]
  node_devtoolsbackend["Extension Backend<br/>[backendManager.js]"]
end

node_app(("Application"))

node_app -->|"uses APIs"| node_react
node_app -.->|"mounts UI"| node_dom
node_react -.->|"coordinates updates"| node_reconciler
node_reconciler -.->|"renders to DOM"| node_dom
node_app -.->|"renders on server"| node_domserver
node_app -.->|"uses server components"| node_flightserver
node_flightclient -->|"uses reply client"| node_flightreply
node_compilerplugin -->|"creates environment"| node_environment
node_compilerplugin -->|"lowers function"| node_hir
node_compilerplugin -->|"runs inference"| node_analysis
node_compilerplugin -->|"builds scopes"| node_reactive
node_rustpipeline -->|"produces results"| node_compilerresult

click node_react "https://github.com/facebook/react/blob/main/packages/react/src/ReactClient.js"
click node_reconciler "https://github.com/facebook/react/tree/main/packages/react-reconciler/src"
click node_dom "https://github.com/facebook/react/blob/main/packages/react-dom/src/client/ReactDOMClientFB.js"
click node_syncstore "https://github.com/facebook/react/blob/main/packages/use-sync-external-store/src/useSyncExternalStoreShimClient.js"
click node_domserver "https://github.com/facebook/react/blob/main/packages/react-dom/server.bun.js"
click node_flightserver "https://github.com/facebook/react/tree/main/packages/react-server-dom-webpack/src/server"
click node_flightclient "https://github.com/facebook/react/blob/main/packages/react-client/src/ReactFlightClient.js"
click node_flightreply "https://github.com/facebook/react/blob/main/packages/react-client/src/ReactFlightReplyClient.js"
click node_compilerplugin "https://github.com/facebook/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts"
click node_environment "https://github.com/facebook/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/HIR/Environment.ts"
click node_hir "https://github.com/facebook/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/HIR/BuildHIR.ts"
click node_analysis "https://github.com/facebook/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/Inference"
click node_reactive "https://github.com/facebook/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes"
click node_rustpipeline "https://github.com/facebook/react/blob/main/compiler/crates/react_compiler/src/entrypoint/pipeline.rs"
click node_compilerresult "https://github.com/facebook/react/blob/main/compiler/crates/react_compiler/src/entrypoint/compile_result.rs"
click node_devtools "https://github.com/facebook/react/blob/main/packages/react-devtools/app.js"
click node_devtoolsbackground "https://github.com/facebook/react/blob/main/packages/react-devtools-extensions/src/background/tabsManager.js"
click node_devtoolsbackend "https://github.com/facebook/react/blob/main/packages/react-devtools-extensions/src/contentScripts/backendManager.js"

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_react,node_reconciler,node_dom,node_syncstore toneBlue
class node_domserver,node_flightserver,node_flightclient,node_flightreply toneAmber
class node_compilerplugin,node_environment,node_hir,node_analysis,node_reactive,node_rustpipeline,node_compilerresult toneMint
class node_devtools,node_devtoolsbackground,node_devtoolsbackend toneRose
class node_app toneIndigo
```

## Components

### React UI Runtime

- [React APIs](https://github.com/facebook/react/blob/main/packages/react/src/ReactClient.js): `packages/react/src/ReactClient.js`
- [Reconciler](https://github.com/facebook/react/tree/main/packages/react-reconciler/src): `packages/react-reconciler/src`
- [DOM Renderer](https://github.com/facebook/react/blob/main/packages/react-dom/src/client/ReactDOMClientFB.js): `packages/react-dom/src/client/ReactDOMClientFB.js`
- [External Store Hook](https://github.com/facebook/react/blob/main/packages/use-sync-external-store/src/useSyncExternalStoreShimClient.js): `packages/use-sync-external-store/src/useSyncExternalStoreShimClient.js`

### Server Rendering and Flight

- [Server Renderer](https://github.com/facebook/react/blob/main/packages/react-dom/server.bun.js): `packages/react-dom/server.bun.js`
- [Flight Servers](https://github.com/facebook/react/tree/main/packages/react-server-dom-webpack/src/server): `packages/react-server-dom-webpack/src/server`
- [Flight Client](https://github.com/facebook/react/blob/main/packages/react-client/src/ReactFlightClient.js): `packages/react-client/src/ReactFlightClient.js`
- [Flight Replies](https://github.com/facebook/react/blob/main/packages/react-client/src/ReactFlightReplyClient.js): `packages/react-client/src/ReactFlightReplyClient.js`

### React Compiler

- [Babel Compiler Plugin](https://github.com/facebook/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts): `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`
- [Compiler Environment](https://github.com/facebook/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/HIR/Environment.ts): `compiler/packages/babel-plugin-react-compiler/src/HIR/Environment.ts`
- [HIR Construction](https://github.com/facebook/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/HIR/BuildHIR.ts): `compiler/packages/babel-plugin-react-compiler/src/HIR/BuildHIR.ts`
- [Inference and Validation](https://github.com/facebook/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/Inference): `compiler/packages/babel-plugin-react-compiler/src/Inference`
- [Reactive Scopes](https://github.com/facebook/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes): `compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes`
- [Rust Compiler Pipeline](https://github.com/facebook/react/blob/main/compiler/crates/react_compiler/src/entrypoint/pipeline.rs): `compiler/crates/react_compiler/src/entrypoint/pipeline.rs`
- [Compiler Results](https://github.com/facebook/react/blob/main/compiler/crates/react_compiler/src/entrypoint/compile_result.rs): `compiler/crates/react_compiler/src/entrypoint/compile_result.rs`

### React DevTools

- [DevTools](https://github.com/facebook/react/blob/main/packages/react-devtools/app.js): `packages/react-devtools/app.js`
- [Extension Background](https://github.com/facebook/react/blob/main/packages/react-devtools-extensions/src/background/tabsManager.js): `packages/react-devtools-extensions/src/background/tabsManager.js`
- [Extension Backend](https://github.com/facebook/react/blob/main/packages/react-devtools-extensions/src/contentScripts/backendManager.js): `packages/react-devtools-extensions/src/contentScripts/backendManager.js`

### Other components

- **Application**

## Connections

- Application → React APIs: uses APIs (evidence: `README.md`)
- Application → DOM Renderer: mounts UI
- React APIs → Reconciler: coordinates updates
- Reconciler → DOM Renderer: renders to DOM
- Application → Server Renderer: renders on server
- Application → Flight Servers: uses server components
- Flight Client → Flight Replies: uses reply client (evidence: `packages/react-client/src/ReactFlightClient.js`)
- Babel Compiler Plugin → Compiler Environment: creates environment (evidence: `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`)
- Babel Compiler Plugin → HIR Construction: lowers function (evidence: `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`)
- Babel Compiler Plugin → Inference and Validation: runs inference (evidence: `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`)
- Babel Compiler Plugin → Reactive Scopes: builds scopes (evidence: `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`)
- Rust Compiler Pipeline → Compiler Results: produces results (evidence: `compiler/crates/react_compiler/src/entrypoint/pipeline.rs`)
