Repo brief: pmndrs/react-three-fiber

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T17:53:16.627Z · commit ff3899dbf43d

Verdict

Healthy — Strong maintenance signals

• Last commit today
• 19 active contributors
• Distributed ownership (top contributor 46% of recent commits)
• MIT licensed
• 2 more receipts on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

react-three-fiber is a React renderer for Three.js that lets developers build 3D scenes declaratively using JSX components instead of imperative Three.js code. It bridges React's component model and reactive state management with Three.js's graphics rendering, allowing developers to write <mesh />, <geometry />, and other Three.js objects as reusable React components that respond to state changes. Monorepo with yarn workspaces: packages/fiber contains the core React renderer (reconciler.tsx, renderer.tsx, store.ts), packages/test-renderer provides testing utilities, and packages/eslint-plugin offers linting rules for safe usage patterns. The packages/fiber/src/web and…

Start here

Open these first:

• packages/fiber/src/core/reconciler.tsx — React reconciler implementation that bridges React's component tree to Three.js object hierarchy—the core abstraction of…
• packages/fiber/src/core/index.tsx — Main entry point exporting the createRoot/Canvas setup and renderer initialization logic.
• packages/fiber/src/web/Canvas.tsx — Web-specific Canvas component that initializes Three.js renderer and mounts the reconciler in a DOM element.
• packages/fiber/src/core/hooks.tsx — Custom React hooks (useFrame, useThree, etc.) enabling component access to render loop and Three.js context.
• packages/fiber/src/core/store.ts — Zustand-based store managing global render state, camera, scene, and dispatch queue shared across all components.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/pmndrs/react-three-fiber.git
cd react-three-fiber
yarn install

The postinstall script automatically runs preconstruct dev to set up development builds.

Daily commands:

For development: yarn dev (runs preconstruct in dev mode). For examples: yarn examples (runs the example workspace). For testing: yarn test or yarn test:watch. For type checking: yarn typecheck. For linting: `…

…shortened for this brief.

Key cautions & unknowns

• Scorecard: default branch unprotected (0/10)
• 1. React reconciler patching: The postinstall script runs vite build to patch React's reconciler internals. This build step must succeed or the library will not function in dev mode. 2. **Three.js version…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.