3d Web Experience

davila7/claude-code-templates/cli-tool/components/skills/creative-design/3d-web-experience

作者 davila78da17d671b6f无许可证32K 个星标收录于 2026年10月8日更新于 2026年10月8日仓库今天更新

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. Use when: 3D website, three.js, WebGL, react three fiber, 3D experience.

仅含说明Software Development Design & Creative

AI 生成的概览

指导使用 Three.js、React Three Fiber、Spline 和 WebGL 构建交互式 3D 网页体验。

功能: 该技能为创建网页 3D 体验提供指导，涵盖在 Spline、React Three Fiber、原生 Three.js 与 Babylon.js 之间进行技术栈选择。它给出 3D 模型流程，包括格式选择、减少面数、导出 GLB 以及 glTF 压缩，并展示基于 ScrollControls 和 GSAP 的滚动驱动 3D 模式。它还列出围绕性能、移动端支持和加载状态的反模式。
适用场景: 适用于启动 3D 网页项目时，例如产品配置器、3D 作品集或沉浸式网站。也适合准备网页用 3D 资源，或将 3D 与页面滚动结合的场景。
运行要求: 仅为说明性内容，不附带脚本。文中模式涉及 Three.js、React Three Fiber、@react-three/drei、Spline、GSAP 以及 gltf-transform 命令行工具等 JavaScript 库和工具，需要在目标项目中自行安装。

3D Web Experience

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.

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

python

## 3D Stack Selection
### Options Comparison| Tool | Best For | Learning Curve | Control ||------|----------|----------------|---------|| 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

## 3D Stack Selection
### Options Comparison| Tool | Best For | Learning Curve | Control ||------|----------|----------------|---------|| 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

Need quick 3D element? └── Yes → Spline └── No → Continue

Using React? └── Yes → React Three Fiber └── No → Continue

Need max performance/control? └── Yes → Three.js vanilla └── No → Spline or R3F


### Spline (Fastest Start)```jsximport Spline from '@splinetool/react-spline';
export default function Scene() {  return (    <Spline scene="https://prod.spline.design/xxx/scene.splinecode" />  );}


### Spline (Fastest Start)```jsximport Spline from '@splinetool/react-spline';
export default function Scene() {  return (    <Spline scene="https://prod.spline.design/xxx/scene.splinecode" />  );}

React Three Fiber

jsx

import { Canvas } from '@react-three/fiber';import { OrbitControls, useGLTF } from '@react-three/drei';
function Model() {  const { scene } = useGLTF('/model.glb');  return <primitive object={scene} />;}
export default function Scene() {  return (    <Canvas>      <ambientLight />      <Model />      <OrbitControls />    </Canvas>  );}

import { Canvas } from '@react-three/fiber';import { OrbitControls, useGLTF } from '@react-three/drei';
function Model() {  const { scene } = useGLTF('/model.glb');  return <primitive object={scene} />;}
export default function Scene() {  return (    <Canvas>      <ambientLight />      <Model />      <OrbitControls />    </Canvas>  );}


### 3D Model Pipeline
Getting models web-ready
**When to use**: When preparing 3D assets
```python## 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


### 3D Model Pipeline
Getting models web-ready
**When to use**: When preparing 3D assets
```python## 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

Model in Blender/etc
Reduce poly count (< 100K for web)
Bake textures (combine materials)
Export as GLB
Compress with gltf-transform
Test file size (< 5MB ideal)


### GLTF Compression```bash# Install gltf-transformnpm install -g @gltf-transform/cli
# Compress modelgltf-transform optimize input.glb output.glb \  --compress draco \  --texture-compress webp


### GLTF Compression```bash# Install gltf-transformnpm install -g @gltf-transform/cli
# Compress modelgltf-transform optimize input.glb output.glb \  --compress draco \  --texture-compress webp

Loading in R3F

jsx

import { useGLTF, useProgress, Html } from '@react-three/drei';import { Suspense } from 'react';
function Loader() {  const { progress } = useProgress();  return <Html center>{progress.toFixed(0)}%</Html>;}
export default function Scene() {  return (    <Canvas>      <Suspense fallback={<Loader />}>        <Model />      </Suspense>    </Canvas>  );}

import { useGLTF, useProgress, Html } from '@react-three/drei';import { Suspense } from 'react';
function Loader() {  const { progress } = useProgress();  return <Html center>{progress.toFixed(0)}%</Html>;}
export default function Scene() {  return (    <Canvas>      <Suspense fallback={<Loader />}>        <Model />      </Suspense>    </Canvas>  );}


### Scroll-Driven 3D
3D that responds to scroll
**When to use**: When integrating 3D with scroll
```python## Scroll-Driven 3D
### R3F + Scroll Controls```jsximport { ScrollControls, useScroll } from '@react-three/drei';import { useFrame } from '@react-three/fiber';
function RotatingModel() {  const scroll = useScroll();  const ref = useRef();
  useFrame(() => {    // Rotate based on scroll position    ref.current.rotation.y = scroll.offset * Math.PI * 2;  });
  return <mesh ref={ref}>...</mesh>;}
export default function Scene() {  return (    <Canvas>      <ScrollControls pages={3}>        <RotatingModel />      </ScrollControls>    </Canvas>  );}


### Scroll-Driven 3D
3D that responds to scroll
**When to use**: When integrating 3D with scroll
```python## Scroll-Driven 3D
### R3F + Scroll Controls```jsximport { ScrollControls, useScroll } from '@react-three/drei';import { useFrame } from '@react-three/fiber';
function RotatingModel() {  const scroll = useScroll();  const ref = useRef();
  useFrame(() => {    // Rotate based on scroll position    ref.current.rotation.y = scroll.offset * Math.PI * 2;  });
  return <mesh ref={ref}>...</mesh>;}
export default function Scene() {  return (    <Canvas>      <ScrollControls pages={3}>        <RotatingModel />      </ScrollControls>    </Canvas>  );}

GSAP + Three.js

javascript

import gsap from 'gsap';import ScrollTrigger from 'gsap/ScrollTrigger';
gsap.to(camera.position, {  scrollTrigger: {    trigger: '.section',    scrub: true,  },  z: 5,  y: 2,});

import gsap from 'gsap';import ScrollTrigger from 'gsap/ScrollTrigger';
gsap.to(camera.position, {  scrollTrigger: {    trigger: '.section',    scrub: true,  },  z: 5,  y: 2,});

Common Scroll Effects

Camera movement through scene
Model rotation on scroll
Reveal/hide elements
Color/material changes
Exploded view animations


## Anti-Patterns
### ❌ 3D For 3D's Sake
**Why bad**: Slows down the site.Confuses users.Battery drain on mobile.Doesn't help conversion.
**Instead**: 3D should serve a purpose.Product visualization = good.Random floating shapes = probably not.Ask: would an image work?
### ❌ Desktop-Only 3D
**Why bad**: Most traffic is mobile.Kills battery.Crashes on low-end devices.Frustrated users.
**Instead**: Test on real mobile devices.Reduce quality on mobile.Provide static fallback.Consider disabling 3D on low-end.
### ❌ No Loading State
**Why bad**: Users think it's broken.High bounce rate.3D takes time to load.Bad first impression.
**Instead**: Loading progress indicator.Skeleton/placeholder.Load 3D after page is interactive.Optimize model size.
## Related Skills
Works well with: `scroll-experience`, `interactive-portfolio`, `frontend`, `landing-page-design`


## Anti-Patterns
### ❌ 3D For 3D's Sake
**Why bad**: Slows down the site.Confuses users.Battery drain on mobile.Doesn't help conversion.
**Instead**: 3D should serve a purpose.Product visualization = good.Random floating shapes = probably not.Ask: would an image work?
### ❌ Desktop-Only 3D
**Why bad**: Most traffic is mobile.Kills battery.Crashes on low-end devices.Frustrated users.
**Instead**: Test on real mobile devices.Reduce quality on mobile.Provide static fallback.Consider disabling 3D on low-end.
### ❌ No Loading State
**Why bad**: Users think it's broken.High bounce rate.3D takes time to load.Bad first impression.
**Instead**: Loading progress indicator.Skeleton/placeholder.Load 3D after page is interactive.Optimize model size.
## Related Skills
Works well with: `scroll-experience`, `interactive-portfolio`, `frontend`, `landing-page-design`

来源与署名

来源：davila7/claude-code-templates位于cli-tool/components/skills/creative-design/3d-web-experience提交8da17d6

许可证：无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

3d Web Experience

3D Web Experience

Capabilities

Patterns

3D Stack Selection

React Three Fiber

Loading in R3F

GSAP + Three.js

Common Scroll Effects

来源与署名

更多来自 davila7/claude-code-templates 的技能

React Best Practices

Web Performance Optimization

Find Bugs

Browser Automation

Code Review

Commit

更多Software Development技能

Playground

M5 Onboard

Cardputer Buddy

Web Design Guidelines

Vercel React Native Skills

Vercel React Best Practices