# poteto/react architecture

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

- Interactive diagram: https://gitdiagram.com/poteto/react
- Repository: https://github.com/poteto/react

## Overview

React is a JavaScript library for building declarative, component-based user interfaces, with support for server rendering and mobile through React Native. The primary workflow is to define components and state, render them into a host UI, and update the UI as data changes. This repository also contains the React Compiler and the React Server Components transport client. The graph combines README-documented product flows with a few source-index and excerpt-supported compiler/transport links; unsampled package internals are represented only where their subsystem is clear from the tree.

Main entry points: [`compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`](https://github.com/poteto/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts) (Compile pipeline), [`packages/react-dom/src/client/ReactDOMClientFB.js`](https://github.com/poteto/react/blob/main/packages/react-dom/src/client/ReactDOMClientFB.js) (DOM renderer), [`packages/react-dom/src/server`](https://github.com/poteto/react/tree/main/packages/react-dom/src/server) (Server rendering), [`packages/react-client/src/ReactFlightClient.js`](https://github.com/poteto/react/blob/main/packages/react-client/src/ReactFlightClient.js) (Flight client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["UI Runtime"]
  node_components["UI components"]
  node_react["React APIs<br/>[ReactClient.js]"]
  node_dom["DOM renderer"]
  node_native["Native renderer"]
end

subgraph group_server["Server Rendering"]
  node_serverrender["Server rendering"]
  node_flightserver["Flight server adapters"]
  node_flightclient["Flight client"]
  node_flightreply["Reply decoding"]
end

subgraph group_compiler["React Compiler"]
  node_babelplugin["Babel plugin<br/>[BabelPlugin.ts]"]
  node_program["Program entry<br/>[Program.ts]"]
  node_pipeline["Compile pipeline<br/>[Pipeline.ts]"]
  node_hir["HIR lowering<br/>[BuildHIR.ts]"]
  node_analysis["Inference and scopes"]
  node_optimize["Optimization passes"]
  node_validate["Compiler validation"]
end

subgraph group_tools["Developer Tools"]
  node_devtools["React DevTools<br/>[app.js]"]
end

node_developer(("Application developer"))
node_uiresult["Rendered UI"]
node_compileruser(("Compiler integrator"))
node_compiled["Compiled component"]

node_developer -->|"defines"| node_components
node_developer -->|"creates root"| node_dom
node_components -->|"renders through"| node_dom
node_react -.->|"renders UI"| node_dom
node_dom -->|"updates UI"| node_uiresult
node_components -.->|"renders on mobile"| node_native
node_developer -.->|"requests rendering"| node_serverrender
node_serverrender -.->|"renders HTML"| node_uiresult
node_flightserver -.->|"streams component data"| node_flightclient
node_flightclient -->|"uses reply client"| node_flightreply
node_compileruser -.->|"configures compilation"| node_babelplugin
node_babelplugin -.->|"enters program"| node_program
node_program -.->|"invokes pipeline"| node_pipeline
node_pipeline -->|"lowers function"| node_hir
node_pipeline -->|"runs inference"| node_analysis
node_pipeline -->|"runs passes"| node_optimize
node_pipeline -->|"validates HIR"| node_validate
node_pipeline -.->|"produces code"| node_compiled

click node_react "https://github.com/poteto/react/blob/main/packages/react/src/ReactClient.js"
click node_dom "https://github.com/poteto/react/blob/main/packages/react-dom/src/client/ReactDOMClientFB.js"
click node_native "https://github.com/poteto/react/blob/main/packages/react-native-renderer/src/ReactFabricGlobalResponderHandler.js"
click node_serverrender "https://github.com/poteto/react/tree/main/packages/react-dom/src/server"
click node_flightserver "https://github.com/poteto/react/tree/main/packages/react-server-dom-webpack/src/server"
click node_flightclient "https://github.com/poteto/react/blob/main/packages/react-client/src/ReactFlightClient.js"
click node_flightreply "https://github.com/poteto/react/blob/main/packages/react-client/src/ReactFlightReplyClient.js"
click node_babelplugin "https://github.com/poteto/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Babel/BabelPlugin.ts"
click node_program "https://github.com/poteto/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Program.ts"
click node_pipeline "https://github.com/poteto/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts"
click node_hir "https://github.com/poteto/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/HIR/BuildHIR.ts"
click node_analysis "https://github.com/poteto/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/Inference"
click node_optimize "https://github.com/poteto/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/Optimization"
click node_validate "https://github.com/poteto/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/Validation"
click node_devtools "https://github.com/poteto/react/blob/main/packages/react-devtools/app.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_components,node_react,node_dom,node_native,node_uiresult toneBlue
class node_serverrender,node_flightserver,node_flightclient,node_flightreply toneAmber
class node_babelplugin,node_program,node_pipeline,node_hir,node_analysis,node_optimize,node_validate toneMint
class node_devtools toneRose
class node_developer,node_compileruser,node_compiled toneIndigo
```

## Components

### UI Runtime

- **UI components**
- [React APIs](https://github.com/poteto/react/blob/main/packages/react/src/ReactClient.js): `packages/react/src/ReactClient.js`
- [DOM renderer](https://github.com/poteto/react/blob/main/packages/react-dom/src/client/ReactDOMClientFB.js): `packages/react-dom/src/client/ReactDOMClientFB.js`
- [Native renderer](https://github.com/poteto/react/blob/main/packages/react-native-renderer/src/ReactFabricGlobalResponderHandler.js): `packages/react-native-renderer/src/ReactFabricGlobalResponderHandler.js`

### Server Rendering

- [Server rendering](https://github.com/poteto/react/tree/main/packages/react-dom/src/server): `packages/react-dom/src/server`
- [Flight server adapters](https://github.com/poteto/react/tree/main/packages/react-server-dom-webpack/src/server): `packages/react-server-dom-webpack/src/server`
- [Flight client](https://github.com/poteto/react/blob/main/packages/react-client/src/ReactFlightClient.js): `packages/react-client/src/ReactFlightClient.js`
- [Reply decoding](https://github.com/poteto/react/blob/main/packages/react-client/src/ReactFlightReplyClient.js): `packages/react-client/src/ReactFlightReplyClient.js`

### React Compiler

- [Babel plugin](https://github.com/poteto/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Babel/BabelPlugin.ts): `compiler/packages/babel-plugin-react-compiler/src/Babel/BabelPlugin.ts`
- [Program entry](https://github.com/poteto/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Program.ts): `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Program.ts`
- [Compile pipeline](https://github.com/poteto/react/blob/main/compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts): `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`
- [HIR lowering](https://github.com/poteto/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 scopes](https://github.com/poteto/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/Inference): `compiler/packages/babel-plugin-react-compiler/src/Inference`
- [Optimization passes](https://github.com/poteto/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/Optimization): `compiler/packages/babel-plugin-react-compiler/src/Optimization`
- [Compiler validation](https://github.com/poteto/react/tree/main/compiler/packages/babel-plugin-react-compiler/src/Validation): `compiler/packages/babel-plugin-react-compiler/src/Validation`

### Developer Tools

- [React DevTools](https://github.com/poteto/react/blob/main/packages/react-devtools/app.js): `packages/react-devtools/app.js`

### Other components

- **Application developer**
- **Rendered UI**
- **Compiler integrator**
- **Compiled component**

## Connections

- Application developer → UI components: defines
- Application developer → DOM renderer: creates root
- UI components → DOM renderer: renders through
- React APIs → DOM renderer: renders UI
- DOM renderer → Rendered UI: updates UI
- UI components → Native renderer: renders on mobile
- Application developer → Server rendering: requests rendering
- Server rendering → Rendered UI: renders HTML
- Flight server adapters → Flight client: streams component data
- Flight client → Reply decoding: uses reply client (evidence: `packages/react-client/src/ReactFlightClient.js`)
- Compiler integrator → Babel plugin: configures compilation
- Babel plugin → Program entry: enters program
- Program entry → Compile pipeline: invokes pipeline
- Compile pipeline → HIR lowering: lowers function (evidence: `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`)
- Compile pipeline → Inference and scopes: runs inference (evidence: `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`)
- Compile pipeline → Optimization passes: runs passes (evidence: `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`)
- Compile pipeline → Compiler validation: validates HIR (evidence: `compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts`)
- Compile pipeline → Compiled component: produces code
