SuperAPI AI Directory

react-three-fiber

Coding & development

View repository

Updated 11-04 18:33

About this skill

React Three Fiber (R3F)

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 /next is 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/r3f is handled by the theatrejs skill.@react-three/drei is 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:

  1. Find the category corresponding to the task in the mapping table below
  2. Refer to that category's references/{category}/README.md to identify the target page
  3. Read the target page's .md to 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