How pmndrs/react-three-fiber works
@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: Canvas.tsx Native Canvas · store.ts Root State · events.ts Event System · reconciler.tsx Scene Reconciler
Components 24
Fiber Runtime
- Root Management
packages/fiber/src/core/root.tsx - Scene Reconciler
packages/fiber/src/core/reconciler.tsx - Renderer Config
packages/fiber/src/core/configuration.ts - Scene Utilities
packages/fiber/src/core/utils.tsx - Object Catalogue
packages/fiber/src/core/extend.ts - Scene Types
packages/fiber/src/three-types.ts - Root State
packages/fiber/src/core/store.ts - Event System
packages/fiber/src/core/events.ts - React Hooks
packages/fiber/src/core/hooks.tsx - Render Loop
packages/fiber/src/core/loop.ts - Scene Portals
packages/fiber/src/core/portal.tsx - React Bridge
packages/fiber/src/core/utils/react.tsx
Canvas Platforms
- Web Canvas
packages/fiber/src/web/Canvas.tsx - Native Canvas
packages/fiber/src/native/Canvas.tsx - Native Adapter
packages/fiber/src/native.tsx - Web Events
packages/fiber/src/web/events.ts - Native Events
packages/fiber/src/native/events.ts
ESLint Plugin
- Plugin Entry
packages/eslint-plugin/src/index.ts - Rule Configs
packages/eslint-plugin/src/configs - Lint Rules
packages/eslint-plugin/src/rules - Rule URL Helper
packages/eslint-plugin/src/lib/url.ts
Other components
- Scene Author
- Three.js
- Plugin User
Connections 28
- 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
packages/fiber/src/web/Canvas.tsx - Native Canvas → Root State: uses state
packages/fiber/src/native/Canvas.tsx - Web Canvas → Web Events: uses events
packages/fiber/src/web/Canvas.tsx - Native Canvas → Web Events: uses events
packages/fiber/src/native/Canvas.tsx - Native Adapter → Native Canvas: exports adapter
packages/fiber/src/native.tsx - Native Adapter → Native Events: exports events
packages/fiber/src/native.tsx - Scene Reconciler → Scene Utilities: applies props
packages/fiber/src/core/reconciler.tsx - Scene Reconciler → Event System: updates interactivity
packages/fiber/src/core/reconciler.tsx - Scene Reconciler → Object Catalogue: resolves objects
packages/fiber/src/core/reconciler.tsx - Scene Reconciler → Three.js: creates objects
packages/fiber/src/core/reconciler.tsx - Object Catalogue → Scene Types: uses types
packages/fiber/src/core/extend.ts - Root State → Scene Utilities: updates camera
packages/fiber/src/core/store.ts - Event System → Scene Utilities: gets root state
packages/fiber/src/core/events.ts - Web Events → Root State: uses state
packages/fiber/src/web/events.ts - Web Events → Event System: uses event types
packages/fiber/src/web/events.ts - Native Events → Root State: uses state
packages/fiber/src/native/events.ts - Native Events → Event System: uses event types
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
packages/eslint-plugin/src/index.ts - Plugin Entry → Lint Rules: exports rules
packages/eslint-plugin/src/index.ts - Lint Rules → Rule URL Helper: uses helper
packages/eslint-plugin/src/rules/index.ts