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.

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

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" />  );}

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>  );}

### 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
  1. Model in Blender/etc
  2. Reduce poly count (< 100K for web)
  3. Bake textures (combine materials)
  4. Export as GLB
  5. Compress with gltf-transform
  6. 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

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>  );}

### 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,});

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`

來源與署名

來源:davila7/claude-code-templates位於cli-tool/components/skills/creative-design/3d-web-experience提交8da17d6

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架