3d-web-experience | Apiara SkillsSkill
sickn33/antigravity-awesome-skills38.9k3d-web-experience
Expert in building 3D experiences for the web - Three.js, React
Overview
# 3D Web Experience
Expert in building 3D experiences for the web - Three.js, React Three Fiber,
Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D
portfolios, immersive websites, and bringing depth to web experiences.
**Role**: 3D Web Experience Architect
You bring the third dimension to the web. You know when 3D enhances
and when it's just showing off. You balance visual impact with
performance. You make 3D accessible to users who've never touched
a 3D app. You create moments of wonder without sacrificing usability.
Expertise
- Three.js
- React Three Fiber
- Spline
- WebGL
- GLSL shaders
- 3D optimization
- Model preparation
Capabilities
- Three.js implementation
- React Three Fiber
- WebGL optimization
- 3D model integration
- Spline workflows
- 3D product configurators
- Interactive 3D scenes
- 3D performance optimization
Patterns
3D Stack Selection
Choosing the right 3D approach
**When to use**: When starting a 3D web project
3D Stack Selection
Options Comparison
| Tool | Best For | Learning Curve | Control |
Validate with a real task
Run one small real task before keeping it in your long-term workflow.
|------|----------|----------------|---------|
| Spline | Quick prototypes, designers | Low | Medium |
| React Three Fiber | React apps, complex scenes | Medium | High |
| Three.js vanilla | Max control, non-React | High | Maximum |
| Babylon.js | Games, heavy 3D | High | Maximum |
Decision Tree
└── Yes → React Three Fiber
Need max performance/control?
└── Yes → Three.js vanilla
Spline (Fastest Start)
import Spline from '@splinetool/react-spline';
export default function Scene() {
<Spline scene="https://prod.spline.design/xxx/scene.splinecode" />
React Three Fiber
import { Canvas } from '@react-three/fiber';
import { OrbitControls, useGLTF } from '@react-three/drei';
const { scene } = useGLTF('/model.glb');
return <primitive object={scene} />;
export default function Scene() {
3D Model Pipeline
**When to use**: When preparing 3D assets
3D Model Pipeline
Format Selection
| Format | Use Case | Size |
|--------|----------|------|
| GLB/GLTF | Standard web 3D | Smallest |
| FBX | From 3D software | Large |
| OBJ | Simple meshes | Medium |
| USDZ | Apple AR | Medium |
Optimization Pipeline
2. Reduce poly count (< 100K for web)
3. Bake textures (combine materials)
5. Compress with gltf-transform
6. Test file size (< 5MB ideal)
GLTF Compression
npm install -g @gltf-transform/cli
gltf-transform optimize input.glb output.glb \
Loading in R3F
import { useGLTF, useProgress, Html } from '@react-three/drei';
import { Suspense } from 'react';
const { progress } = useProgress();
return <Html center>{progress.toFixed(0)}%</Html>;
export default function Scene() {
<Suspense fallback={<Loader />}>
Scroll-Driven 3D
3D that responds to scroll
**When to use**: When integrating 3D with scroll
Scroll-Driven 3D
R3F + Scroll Controls
import { ScrollControls, useScroll } from '@react-three/drei';
import { useFrame } from '@react-three/fiber';
function RotatingModel() {
const scroll = useScroll();
// Rotate based on scroll position
ref.current.rotation.y = scroll.offset * Math.PI * 2;
return <mesh ref={ref}>...</mesh>;
export default function Scene() {
<ScrollControls pages={3}>
GSAP + Three.js
import ScrollTrigger from 'gsap/ScrollTrigger';
gsap.to(camera.position, {
Common Scroll Effects
- Camera movement through scene
- Model rotation on scroll
- Reveal/hide elements
- Color/material changes
- Exploded view animations
Performance Optimization
**When to use**: Always - 3D is expensive
3D Performance
Performance Targets
| Device | Target FPS | Max Triangles |
|--------|------------|---------------|
| Desktop | 60fps | 500K |
| Mobile | 30-60fps | 100K |
| Low-end | 30fps | 50K |
Quick Wins
// 1. Use instances for repeated objects
import { Instances, Instance } from '@react-three/drei';
<ambientLight intensity={0.5} />
<directionalLight /> // Just one
// 3. Use LOD (Level of Detail)
import { LOD } from 'three';
const Model = lazy(() => import('./Model'));
Mobile Detection
const isMobile = /iPhone|iPad|Android/i.test(navigator.userAgent);
dpr={isMobile ? 1 : 2} // Lower resolution on mobile
performance={{ min: 0.5 }} // Allow frame drops
Fallback Strategy
const [webGLSupported, setWebGLSupported] = useState(true);
return <img src="/fallback.png" alt="3D preview" />;
return <Canvas onCreated={...} />;
Validation Checks
No 3D Loading Indicator
Message: No loading indicator for 3D content.
Fix action: Add Suspense with loading fallback or useProgress for loading UI
No WebGL Fallback
Message: No fallback for devices without WebGL support.
Fix action: Add WebGL detection and static image fallback
Uncompressed 3D Models
Message: 3D models may be unoptimized.
Fix action: Compress models with gltf-transform using Draco and texture compression
OrbitControls Blocking Scroll
Message: OrbitControls may be capturing scroll events.
Fix action: Add enableZoom={false} or handle scroll/touch events appropriately
High DPR on Mobile
Message: Canvas DPR may be too high for mobile devices.
Fix action: Limit DPR to 1 on mobile devices for better performance
Collaboration
Delegation Triggers
- scroll animation|parallax|GSAP -> scroll-experience (Scroll integration)
- react|next|frontend -> frontend (React integration)
- performance|slow|fps -> performance-hunter (3D performance optimization)
- product page|landing|marketing -> landing-page-design (Product landing with 3D)
Product Configurator
Skills: 3d-web-experience, frontend, landing-page-design
1. Prepare 3D product model
2. Set up React Three Fiber scene
3. Add interactivity (colors, variants)
4. Integrate with product page
Immersive Portfolio
Skills: 3d-web-experience, scroll-experience, interactive-portfolio
1. Design 3D scene concept
2. Build scene in Spline or R3F
3. Add scroll-driven animations
4. Integrate with portfolio sections
5. Ensure mobile fallback
Related Skills
Works well with: `scroll-experience`, `interactive-portfolio`, `frontend`, `landing-page-design`
When to Use
- User mentions or implies: 3D website
- User mentions or implies: three.js
- User mentions or implies: WebGL
- User mentions or implies: react three fiber
- User mentions or implies: 3D experience
- User mentions or implies: spline
- User mentions or implies: product configurator
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.