How facebook/react works
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: Pipeline.ts Babel Compiler Plugin · ReactClient.js React APIs · src Reconciler · ReactDOMClientFB.js DOM Renderer
Components 19
React UI Runtime
- React APIs
packages/react/src/ReactClient.js - Reconciler
packages/react-reconciler/src - DOM Renderer
packages/react-dom/src/client/ReactDOMClientFB.js - External Store Hook
packages/use-sync-external-store/src/useSyncExternalStoreShimClient.js
Server Rendering and Flight
- Server Renderer
packages/react-dom/server.bun.js - Flight Servers
packages/react-server-dom-webpack/src/server - Flight Client
packages/react-client/src/ReactFlightClient.js - Flight Replies
packages/react-client/src/ReactFlightReplyClient.js
React Compiler
- Babel Compiler Plugin
compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts - Compiler Environment
compiler/packages/babel-plugin-react-compiler/src/HIR/Environment.ts - HIR Construction
compiler/packages/babel-plugin-react-compiler/src/HIR/BuildHIR.ts - Inference and Validation
compiler/packages/babel-plugin-react-compiler/src/Inference - Reactive Scopes
compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes - Rust Compiler Pipeline
compiler/crates/react_compiler/src/entrypoint/pipeline.rs - Compiler Results
compiler/crates/react_compiler/src/entrypoint/compile_result.rs
React DevTools
- DevTools
packages/react-devtools/app.js - Extension Background
packages/react-devtools-extensions/src/background/tabsManager.js - Extension Backend
packages/react-devtools-extensions/src/contentScripts/backendManager.js
Other components
- Application
Connections 12
- Application → React APIs: uses APIs
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
packages/react-client/src/ReactFlightClient.js - Babel Compiler Plugin → Compiler Environment: creates environment
compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts - Babel Compiler Plugin → HIR Construction: lowers function
compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts - Babel Compiler Plugin → Inference and Validation: runs inference
compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts - Babel Compiler Plugin → Reactive Scopes: builds scopes
compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts - Rust Compiler Pipeline → Compiler Results: produces results
compiler/crates/react_compiler/src/entrypoint/pipeline.rs