3d-product-configuratorlisted
Install: claude install-skill RaveenDi/Skilloadout
# 3D Product Configurator & Showcase
A configurator has two jobs: make the product look *better than a photo*, and make choices
feel instant. Design the state model first, then the look, then the motion.
## 1. State model (source of truth outside the 3D scene)
```ts
type Config = { color: "graphite" | "silver" | "sand"; strap: "leather" | "steel"; engraving?: string };
type Option = { id: string; label: string; price: number; swatch: string; apply: (scene: SceneRefs) => void };
```
- Keep config in a store (zustand/URL params) — the scene *renders* the config; UI never mutates meshes directly.
- Serialize to the URL (`?color=sand&strap=steel`) so every configuration is shareable and SEO-crawlable.
- Price and availability are computed from config, never from the scene.
## 2. Asset preparation
- One GLB per product with **named nodes per swappable part** (`part_strap_leather`, `part_strap_steel`) and **named materials** (`mat_body`, `mat_glass`).
- Variants: use the `KHR_materials_variants` glTF extension (Blender exporter supports it) — switch variants without reloading.
- Bake AO; keep normal maps; KTX2 textures; Meshopt. Hero products may justify 2K textures on desktop only.
## 3. Studio look
- **Lighting:** HDRI studio environment (`scene.environment`, low-res PMREM) + 1 key directional for crisp shadows + optional rim light. Tone map ACES/AgX, exposure ≈ 1.
- **Ground:** contact shadows (drei `<ContactShadows>` or baked shadow plane) — floating products look fake.