# pmndrs/react-three-fiber architecture

> Architecture diagram of the GitHub repository pmndrs/react-three-fiber, 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/pmndrs/react-three-fiber
- Repository: https://github.com/pmndrs/react-three-fiber

## Overview

@react-three/fiber is a React renderer for Three.js: users describe scenes in JSX, mount them in a Canvas, then update and interact with Three.js objects through React state, hooks, and pointer events. The runtime has distinct reconciliation, scene configuration, rendering-loop, and event-management responsibilities, with web and React Native Canvas adapters. The repository also includes an ESLint plugin as a separate developer-facing package. Some subsystem links are documented or supported by import references; unsampled implementation details are not assumed.

Main entry points: [`packages/fiber/src/native/Canvas.tsx`](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/native/Canvas.tsx) (Native Canvas), [`packages/fiber/src/core/store.ts`](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/store.ts) (Root State), [`packages/fiber/src/core/events.ts`](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/events.ts) (Event System), [`packages/fiber/src/core/reconciler.tsx`](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/reconciler.tsx) (Scene Reconciler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Fiber Runtime"]
  node_root["Root Management<br/>[root.tsx]"]
  node_reconciler["Scene Reconciler<br/>[reconciler.tsx]"]
  node_configuration["Renderer Config<br/>[configuration.ts]"]
  node_scene_utils["Scene Utilities<br/>[utils.tsx]"]
  node_object_catalogue["Object Catalogue<br/>[extend.ts]"]
  node_scene_types["Scene Types<br/>[three-types.ts]"]
  node_state_store["Root State<br/>[store.ts]"]
  node_event_system["Event System<br/>[events.ts]"]
  node_hooks["React Hooks<br/>[hooks.tsx]"]
  node_render_loop["Render Loop<br/>[loop.ts]"]
  node_portals["Scene Portals<br/>[portal.tsx]"]
  node_react_bridge["React Bridge<br/>[react.tsx]"]
end

subgraph group_platform["Canvas Platforms"]
  node_web_canvas["Web Canvas<br/>[Canvas.tsx]"]
  node_native_canvas["Native Canvas<br/>[Canvas.tsx]"]
  node_native_adapter["Native Adapter<br/>[native.tsx]"]
  node_web_events["Web Events<br/>[events.ts]"]
  node_native_events["Native Events<br/>[events.ts]"]
end

subgraph group_lint["ESLint Plugin"]
  node_plugin_entry["Plugin Entry<br/>[index.ts]"]
  node_plugin_configs["Rule Configs"]
  node_plugin_rules["Lint Rules"]
  node_rule_url["Rule URL Helper<br/>[url.ts]"]
end

node_scene_author(("Scene Author"))
node_three["Three.js"]
node_plugin_user(("Plugin User"))

node_scene_author -->|"mounts scene"| node_web_canvas
node_scene_author -->|"mounts scene"| node_native_canvas
node_web_canvas -.->|"creates root"| node_root
node_native_canvas -.->|"configures root"| node_root
node_web_canvas -->|"uses state"| node_state_store
node_native_canvas -->|"uses state"| node_state_store
node_web_canvas -->|"uses events"| node_web_events
node_native_canvas -->|"uses events"| node_web_events
node_native_adapter -->|"exports adapter"| node_native_canvas
node_native_adapter -->|"exports events"| node_native_events
node_reconciler -->|"applies props"| node_scene_utils
node_reconciler -->|"updates interactivity"| node_event_system
node_reconciler -->|"resolves objects"| node_object_catalogue
node_reconciler -->|"creates objects"| node_three
node_object_catalogue -->|"uses types"| node_scene_types
node_state_store -->|"updates camera"| node_scene_utils
node_event_system -->|"gets root state"| node_scene_utils
node_web_events -->|"uses state"| node_state_store
node_web_events -->|"uses event types"| node_event_system
node_native_events -->|"uses state"| node_state_store
node_native_events -->|"uses event types"| node_event_system
node_scene_author -->|"uses hooks"| node_hooks
node_scene_author -->|"subscribes frames"| node_render_loop
node_scene_author -->|"handles pointer input"| node_event_system
node_plugin_user -.->|"configures linting"| node_plugin_entry
node_plugin_entry -->|"exports configs"| node_plugin_configs
node_plugin_entry -->|"exports rules"| node_plugin_rules
node_plugin_rules -->|"uses helper"| node_rule_url

click node_web_canvas "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/web/Canvas.tsx"
click node_native_canvas "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/native/Canvas.tsx"
click node_native_adapter "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/native.tsx"
click node_root "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/root.tsx"
click node_reconciler "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/reconciler.tsx"
click node_configuration "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/configuration.ts"
click node_scene_utils "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/utils.tsx"
click node_object_catalogue "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/extend.ts"
click node_scene_types "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/three-types.ts"
click node_state_store "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/store.ts"
click node_event_system "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/events.ts"
click node_web_events "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/web/events.ts"
click node_native_events "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/native/events.ts"
click node_hooks "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/hooks.tsx"
click node_render_loop "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/loop.ts"
click node_portals "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/portal.tsx"
click node_react_bridge "https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/utils/react.tsx"
click node_plugin_entry "https://github.com/pmndrs/react-three-fiber/blob/master/packages/eslint-plugin/src/index.ts"
click node_plugin_configs "https://github.com/pmndrs/react-three-fiber/tree/master/packages/eslint-plugin/src/configs"
click node_plugin_rules "https://github.com/pmndrs/react-three-fiber/tree/master/packages/eslint-plugin/src/rules"
click node_rule_url "https://github.com/pmndrs/react-three-fiber/blob/master/packages/eslint-plugin/src/lib/url.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_root,node_reconciler,node_configuration,node_scene_utils,node_object_catalogue,node_scene_types,node_state_store,node_event_system,node_hooks,node_render_loop,node_portals,node_react_bridge,node_plugin_user toneBlue
class node_web_canvas,node_native_canvas,node_native_adapter,node_web_events,node_native_events toneAmber
class node_plugin_entry,node_plugin_configs,node_plugin_rules,node_rule_url toneMint
class node_scene_author,node_three toneIndigo
```

## Components

### Fiber Runtime

- [Root Management](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/root.tsx): `packages/fiber/src/core/root.tsx`
- [Scene Reconciler](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/reconciler.tsx): `packages/fiber/src/core/reconciler.tsx`
- [Renderer Config](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/configuration.ts): `packages/fiber/src/core/configuration.ts`
- [Scene Utilities](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/utils.tsx): `packages/fiber/src/core/utils.tsx`
- [Object Catalogue](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/extend.ts): `packages/fiber/src/core/extend.ts`
- [Scene Types](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/three-types.ts): `packages/fiber/src/three-types.ts`
- [Root State](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/store.ts): `packages/fiber/src/core/store.ts`
- [Event System](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/events.ts): `packages/fiber/src/core/events.ts`
- [React Hooks](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/hooks.tsx): `packages/fiber/src/core/hooks.tsx`
- [Render Loop](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/loop.ts): `packages/fiber/src/core/loop.ts`
- [Scene Portals](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/portal.tsx): `packages/fiber/src/core/portal.tsx`
- [React Bridge](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/core/utils/react.tsx): `packages/fiber/src/core/utils/react.tsx`

### Canvas Platforms

- [Web Canvas](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/web/Canvas.tsx): `packages/fiber/src/web/Canvas.tsx`
- [Native Canvas](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/native/Canvas.tsx): `packages/fiber/src/native/Canvas.tsx`
- [Native Adapter](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/native.tsx): `packages/fiber/src/native.tsx`
- [Web Events](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/web/events.ts): `packages/fiber/src/web/events.ts`
- [Native Events](https://github.com/pmndrs/react-three-fiber/blob/master/packages/fiber/src/native/events.ts): `packages/fiber/src/native/events.ts`

### ESLint Plugin

- [Plugin Entry](https://github.com/pmndrs/react-three-fiber/blob/master/packages/eslint-plugin/src/index.ts): `packages/eslint-plugin/src/index.ts`
- [Rule Configs](https://github.com/pmndrs/react-three-fiber/tree/master/packages/eslint-plugin/src/configs): `packages/eslint-plugin/src/configs`
- [Lint Rules](https://github.com/pmndrs/react-three-fiber/tree/master/packages/eslint-plugin/src/rules): `packages/eslint-plugin/src/rules`
- [Rule URL Helper](https://github.com/pmndrs/react-three-fiber/blob/master/packages/eslint-plugin/src/lib/url.ts): `packages/eslint-plugin/src/lib/url.ts`

### Other components

- **Scene Author**
- **Three.js**
- **Plugin User**

## Connections

- Scene Author → Web Canvas: mounts scene
- Scene Author → Native Canvas: mounts scene
- Web Canvas → Root Management: creates root
- Native Canvas → Root Management: configures root
- Web Canvas → Root State: uses state (evidence: `packages/fiber/src/web/Canvas.tsx`)
- Native Canvas → Root State: uses state (evidence: `packages/fiber/src/native/Canvas.tsx`)
- Web Canvas → Web Events: uses events (evidence: `packages/fiber/src/web/Canvas.tsx`)
- Native Canvas → Web Events: uses events (evidence: `packages/fiber/src/native/Canvas.tsx`)
- Native Adapter → Native Canvas: exports adapter (evidence: `packages/fiber/src/native.tsx`)
- Native Adapter → Native Events: exports events (evidence: `packages/fiber/src/native.tsx`)
- Scene Reconciler → Scene Utilities: applies props (evidence: `packages/fiber/src/core/reconciler.tsx`)
- Scene Reconciler → Event System: updates interactivity (evidence: `packages/fiber/src/core/reconciler.tsx`)
- Scene Reconciler → Object Catalogue: resolves objects (evidence: `packages/fiber/src/core/reconciler.tsx`)
- Scene Reconciler → Three.js: creates objects (evidence: `packages/fiber/src/core/reconciler.tsx`)
- Object Catalogue → Scene Types: uses types (evidence: `packages/fiber/src/core/extend.ts`)
- Root State → Scene Utilities: updates camera (evidence: `packages/fiber/src/core/store.ts`)
- Event System → Scene Utilities: gets root state (evidence: `packages/fiber/src/core/events.ts`)
- Web Events → Root State: uses state (evidence: `packages/fiber/src/web/events.ts`)
- Web Events → Event System: uses event types (evidence: `packages/fiber/src/web/events.ts`)
- Native Events → Root State: uses state (evidence: `packages/fiber/src/native/events.ts`)
- Native Events → Event System: uses event types (evidence: `packages/fiber/src/native/events.ts`)
- Scene Author → React Hooks: uses hooks
- Scene Author → Render Loop: subscribes frames
- Scene Author → Event System: handles pointer input
- Plugin User → Plugin Entry: configures linting
- Plugin Entry → Rule Configs: exports configs (evidence: `packages/eslint-plugin/src/index.ts`)
- Plugin Entry → Lint Rules: exports rules (evidence: `packages/eslint-plugin/src/index.ts`)
- Lint Rules → Rule URL Helper: uses helper (evidence: `packages/eslint-plugin/src/rules/index.ts`)
