Target version: @react-three/fiber 9.8.2(GitHub tag v9.8.2、commit d74622ea8ed717f7212d7e19d65ff3e325508389, npm latest 9.8.2). Bundled: @react-three/test-renderer 9.1.1、@react-three/eslint-plugin 0.1.2. Retrieved on 2026-10-17.
- at the tag,
package.json/ CHANGELOG remains at 9.8.1. Changes in 9.8.2 are documented only in the GitHub Release body (https://github.com/pmndrs/react-three-fiber/releases/tag/v9.8.2) - The root of the official documentation site is identical to the tag. The site's
/nextis v10 alpha, so referencing it is prohibited (v10.0.0-alpha.5 / canary are not included) - The three.js core class APIs (geometry / material / loader / renderer) are covered by the threejs skill, and
@theatre/r3fis handled by the theatrejs skill.@react-three/dreiis a separate package and not included
Directory structure
skills/react-three-fiber/
SKILL.md
references/
getting-started/
README.md
introduction.md
installation.md
how-it-works.md
react-native.md
v9-migration-guide.md
canvas/
README.md
canvas.md
create-root.md
defaults.md
errors-and-fallbacks.md
renderers.md
tree-shaking.md
updating-configuration.md
webgpu.md
hooks/
README.md
root-state.md
use-frame.md
use-graph.md
use-instance-handle.md
use-loader.md
use-three.md
objects/
README.md
attach.md
constructor-arguments.md
declaring-objects.md
disposal.md
piercing-nested-properties.md
primitive.md
shader-material-uniforms.md
shortcuts.md
third-party-objects.md
events/
README.md
customizing-events.md
event-data.md
event-handlers.md
event-propagation.md
event-target-and-prefix.md
pointer-capture.md
raycast-without-interaction.md
exports/
README.md
act.md
add-effect.md
advance.md
apply-props.md
build-graph.md
create-portal.md
events.md
extend.md
flush-sync.md
invalidate.md
other-exports.md
performance/
README.md
concurrency.md
instancing.md
level-of-detail.md
movement-regression.md
nested-loading.md
on-demand-rendering.md
performance-monitoring.md
pitfalls-mounting-and-objects.md
pitfalls-state-and-loops.md
reusing-geometries-materials.md
testing-tooling/
README.md
eslint-no-clone-in-loop.md
eslint-no-new-in-loop.md
eslint-plugin.md
test-instance.md
test-renderer-act.md
test-renderer-create.md
test-renderer-fire-event.md
test-renderer-lifecycle.md
test-renderer-scene-graph.md
testing-overview.md
typescript/
README.md
exported-types.md
extend-types.md
extending-default-elements.md
three-elements.md
typing-with-useref.md
samples/
README.md
basic-animations.md
basic-example.md
events-and-interaction.md
loading-gltf-models.md
loading-obj-fbx-stl-models.md
loading-progress.md
loading-textures.md
testing-with-test-renderer.md
your-first-scene.md
scripts/
README.md
install.md
react-native.md
tooling.md
Exploration procedure
Derive the category from the task, and identify the target page in the category's README.md:
- Find the category corresponding to the task in the mapping table below
- Refer to that category's
references/{category}/README.mdto identify the target page - Read the target page's
.mdto check the details
Task → Category mapping
| Task | Category | Reference README |
|---|---|---|
| Want to know the R3F overview, how it works, and v8 → v9 migration | getting-started | references/getting-started/README.md |
| Want to configure Canvas props, a custom root (createRoot), WebGPU, and renderer replacement | canvas | references/canvas/README.md |
| Want to use useFrame / useThree / useLoader / RootState | hooks | references/hooks/README.md |
| Want to declare three.js objects in JSX with attach, args, primitive, and dispose | objects | references/objects/README.md |
| Want to handle pointer events, propagation, pointer capture, and event targets | events | references/events/README.md |
| Want to look up exports such as extend / invalidate / advance / createPortal / applyProps | exports | references/exports/README.md |
| Want to improve performance with on-demand rendering, instancing, LOD, pitfalls, etc. | performance | references/performance/README.md |
| Want to test with test-renderer, want to introduce ESLint rules | testing-tooling | references/testing-tooling/README.md |
| Want to look up ThreeElements type extension, useRef typing, and public types | typescript | references/typescript/README.md |
| Want to know typical usage (first scene, animation, model loading) | samples | samples/README.md |
| Want to know installation, React Native, and tool setup commands | scripts | scripts/README.md |