zebbern/claude-code-guide / skills/r3f-best-practices
r3f-best-practices
VerifiedReact Three Fiber (R3F) and Poimandres ecosystem best practices. Use when writing, reviewing, or optimizing R3F code. Triggers on tasks involving @react-three/fiber, @react-three/drei, zustand, @react-three/postprocessing, @react-three/rapier, or leva.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.9 KB |
| rules/_sections.md | markdown | 1.9 KB |
| rules/drei-use-gltf.md | markdown | 3.0 KB |
| rules/frame-delta-time.md | markdown | 2.7 KB |
| rules/loading-suspense.md | markdown | 3.6 KB |
| rules/perf-never-set-state-in-useframe.md | markdown | 2.6 KB |
| rules/perf-r3f-perf.md | markdown | 1.9 KB |
| rules/perf-visibility-toggle.md | markdown | 1.9 KB |
| rules/perf-zustand-selectors.md | markdown | 3.0 KB |
rules/drei-use-gltf.md
View on GitHub# drei-use-gltf
**Use useGLTF for model loading with preloading.**
## Why It Matters
`useGLTF` from Drei provides:
- Suspense integration (automatic loading states)
- Caching (same model loaded once)
- Preloading capability
- Draco decompression support
## Basic Example
```jsx
import { useGLTF } from '@react-three/drei';
function Model() {
const { scene, nodes, materials } = useGLTF('/model.glb');
return <primitive object={scene} />;
}
```
## Preloading (Critical for UX)
```jsx
import { useGLTF } from '@react-three/drei';
function Model() {
const { scene } = useGLTF('/model.glb');
return <primitive object={scene} />;
}
// Preload at module level - starts loading immediately
useGLTF.preload('/model.glb');
// Or preload multiple models
useGLTF.preload(['/model1.glb', '/model2.glb', '/model3.glb']);
```
## With Draco Compression
```jsx
function DracoModel() {
// Second argument is the Draco decoder path
const { scene } = useGLTF('/model.glb', '/draco/');
return <primitive object={scene} />;
}
useGLTF.preload('/model.glb', '/draco/');
```
## Accessing Nodes and Materials
```jsx
function Character() {
const { nodes, materials } = useGLTF('/character.glb');
return (
<group>
<mesh
geometry={nodes.Body.geometry}
material={materials.Skin}
/>
<mesh
geometry={nodes.Clothes.geometry}
material={materials.Fabric}
/>
</group>
);
}
```
## Clone for Multiple Instances
```jsx
function Tree({ position }) {
const { scene } = useGLTF('/tree.glb');
// Clone to avoid sharing state between instances
return <primitive object={scene.clone()} position={position} />;
}
function Forest() {
return (
<>
<Tree position={[0, 0, 0]} />
<Tree position={[5, 0, 0]} />
<Tree position={[10, 0, 0]} />
</>
);
}
```
## With Suspense
```jsx
import { Suspense } from 'react';
import { useGLTF } from '@react-three/drei';
function Model() {
const { scene } = useGLTF('/model.glb');
return <primitive object={scene} />;
}
function Scene() {
return (
<Suspense fallback={<LoadingBox />}>
<Model />
</Suspense>
);
}
function LoadingBox() {
return (
<mesh>
<boxGeometry />
<meshBasicMaterial wireframe color="white" />
</mesh>
);
}
```
## TypeScript Types
```tsx
import { useGLTF } from '@react-three/drei';
import { GLTF } from 'three-stdlib';
type GLTFResult = GLTF & {
nodes: {
Body: THREE.Mesh;
Head: THREE.Mesh;
};
materials: {
Skin: THREE.MeshStandardMaterial;
};
};
function Model() {
const { nodes, materials } = useGLTF('/model.glb') as GLTFResult;
// Now nodes.Body and materials.Skin are typed
}
```
## Dispose Handling
R3F auto-disposes by default. To prevent disposal (for shared models):
```jsx
function SharedModel({ model }) {
return <primitive object={model} dispose={null} />;
}
```
## References
- [Drei useGLTF](https://github.com/pmndrs/drei#usegltf)
- [gltfjsx](https://github.com/pmndrs/gltfjsx) - Generate JSX from GLTF
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |