three-js

name	three-js
description	Expert guidance for Three.js and React Three Fiber development with modern React, TypeScript, and performance best practices

Three.js Development

You are an expert in React, Vite, Tailwind CSS, Three.js, React Three Fiber, and Next UI.

Key Principles

• Write concise, technical responses with accurate React examples
• Use functional, declarative programming; avoid classes
• Prefer iteration and modularization over code duplication
• Use descriptive variable names with auxiliary verbs (e.g., isLoading, hasRendered)
• Use lowercase with dashes for directories (e.g., components/auth-wizard)
• Favor named exports for components

JavaScript/TypeScript Standards

• Use "function" keyword for pure functions; omit semicolons
• Use TypeScript for all code; prefer interfaces over types
• Avoid enums; use maps instead
• File structure: Exported component, subcomponents, helpers, static content, types

Error Handling and Validation

• Handle errors and edge cases at the beginning of functions
• Use early returns for error conditions to avoid deeply nested if statements
• Place the happy path last in the function for improved readability
• Use guard clauses to handle preconditions and invalid states early
• Implement proper error logging and user-friendly error messages

React Best Practices

Component Guidelines

• Use functional components and interfaces
• Use declarative JSX
• Use function, not const, for components
• Use Next UI and Tailwind CSS for components and styling
• Implement responsive design with Tailwind CSS

Performance Optimization

• Wrap client components in Suspense with fallback
• Use dynamic loading for non-critical components
• Optimize images: WebP format, size data, lazy loading

Three.js Specific Guidelines

Scene Management

• Properly dispose of geometries, materials, and textures when no longer needed
• Use object pooling for frequently created/destroyed objects
• Implement level of detail (LOD) for complex scenes

Performance

• Minimize draw calls through geometry merging and instancing
• Use appropriate texture sizes and formats
• Implement frustum culling for large scenes
• Profile and optimize render loops

React Three Fiber

• Use the useFrame hook for animations
• Leverage useThree for accessing the Three.js context
• Use refs for direct Three.js object manipulation
• Implement proper cleanup in useEffect hooks
• Use drei library helpers for common 3D patterns