Files
webb/docs/superpowers/plans/2026-11-03-cinematic-3d-transformation.md
T

5.8 KiB

3D Cinematic Graphics Overhaul (Enigma Cult Reference - Light Luxury Theme)

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Transform the website into an immersive 3D cinematic experience inspired by enigmascult.com (scroll-driven horizontal pinning, 3D holographic image comparison, 3D perspective spatial depth), while preserving an airy, high-fashion Light Shade Theme (creamy sandstone #FAF8F5, metallic champagne gold #C5A880, titanium glass, and studio sapphire accents).

Architecture:

  • Cinematic 3D Comparison Viewport (Cinematic3DComparison.tsx): Replaces flat before/after containers with a 3D perspective card (perspective(1400px)) that reacts with real-time inertial 3D tilt to cursor/touch coordinates, floating 3D telemetry tags (translateZ(40px)), an illuminated holographic laser split line with champagne-sapphire edge caustics, and dynamic specular glare.
  • Scroll-Driven Horizontal Motion Gallery (CinematicHorizontalScrollSection.tsx): Pinned vertical-to-horizontal scrolling section where the viewport locks and translates a filmstrip of flagship models horizontally with 3D perspective card rotations (rotateY, scale, translateZ) and index counters (01 / 03).
  • 3D Cinematic Hero & Spatial Atmosphere: Integrates Three.js kinetic neural prism with light-mode refractions into the hero alongside luxury editorial display typography and metallic badges.
  • Light Luxury Color Scheme & CSS Utilities: Added to globals.css (sandstone #FAF8F5, metallic champagne #C5A880, 3D perspective, preserve-3d, deep ambient drop shadows).

Tech Stack: Next.js 14, React 18, Three.js, Lenis Smooth Scroll, Tailwind CSS, Lucide React.


Task 1: Light Luxury 3D Perspective CSS Utilities & Theme Colors

Files:

  • Modify: src/app/globals.css
  • Test: Build verification (npm run build)

Steps:

  • Step 1.1: Add 3D perspective utilities to globals.css (perspective-1000, perspective-1400, preserve-3d, backface-hidden).
  • Step 1.2: Add light-mode luxury color variables and glass tokens (--color-champagne: #C5A880, --color-sandstone: #FAF8F5, --shadow-cinematic-3d).
  • Step 1.3: Add holographic laser line and caustic animation keyframes (@keyframes laser-glow, @keyframes holographic-scan).
  • Step 1.4: Build and verify CSS compile.

Task 2: Build Cinematic3DComparison.tsx (Complete 3D Image Comparison Viewport)

Files:

  • Create: src/components/ui/Cinematic3DComparison.tsx
  • Modify: src/components/ui/BeforeAfterSlider.tsx
  • Test: Verify in browser with interactive dragging, cursor 3D tilting, and holographic laser line.

Steps:

  • Step 2.1: Implement 3D perspective wrapper with mouse/touch inertial tilt (rotateX, rotateY, translateZ).
  • Step 2.2: Implement dynamic specular glare overlay that follows mouse coordinates.
  • Step 2.3: Build holographic split divider with champagne-gold and sapphire laser illumination and 3D tactile circular handle.
  • Step 2.4: Add floating 3D telemetry tags at translateZ(30px) ([ DELTA MAP: ACTIVE ], [ 4K LOSSLESS ]).
  • Step 2.5: Integrate into BeforeAfterSlider.tsx so existing before/after widgets gain the 3D cinematic capabilities.
  • Step 2.6: Verify in Puppeteer.

Files:

  • Create: src/components/sections/CinematicHorizontalScrollSection.tsx
  • Modify: src/components/sections/SectionRenderer.tsx
  • Modify: content/pages/home.json
  • Test: Verify pinned scrolling and horizontal translation in browser.

Steps:

  • Step 3.1: Build sticky pinned container (h-[320vh], sticky top-0 h-screen overflow-hidden) that calculates vertical scroll progress (0 \to 1).
  • Step 3.2: Translate horizontal track with smooth GPU transform translate3d(-${x}px, 0, 0) with 3D perspective rotation on cards based on viewport distance.
  • Step 3.3: Render 3 flagship cards with luxury editorial metadata (INDEX // 01, INDEX // 02, INDEX // 03, technical specs, and embedded 3D image comparison).
  • Step 3.4: Add progress bar at the bottom with luxury gold-to-sapphire indicator and mobile touch-swipe fallback.
  • Step 3.5: Register section in SectionRenderer.tsx and configure in home.json.
  • Step 3.6: Verify in Puppeteer on desktop and mobile viewports.

Task 4: Upgrade Hero Section with 3D Kinetic Neural Prism & Luxury Editorial Layout

Files:

  • Modify: src/components/sections/HeroSection.tsx
  • Modify: src/components/3d/Hero3DCanvas.tsx
  • Test: Verify 3D canvas rendering with luxury light-mode refractions, zero errors, and clean responsive layout.

Steps:

  • Step 4.1: Tune Hero3DCanvas.tsx crystal materials for light luxury aesthetic (translucent sapphire-champagne refraction with high transmission and gold edge lines).
  • Step 4.2: Integrate Hero3DCanvas into HeroSection.tsx behind the hero title with depth layering.
  • Step 4.3: Add Enigma-style metadata chips (NEURAL VISION SUITE // 2026, COORDINATES // STUDIO CORE).
  • Step 4.4: Verify in Puppeteer.

Task 5: Production Build, Server Verification, Frame Rate Benchmarks & Git Commit

Files:

  • All modified components
  • Test: npm run build, route verification script, Puppeteer frame rate benchmark (60/120 FPS).

Steps:

  • Step 5.1: Run npm run build and confirm 0 errors.
  • Step 5.2: Restart production server daemon and run route verification script (verify_changes.py).
  • Step 5.3: Benchmark scroll frame times in Puppeteer and take screenshots of the 3D cinematic comparison and horizontal scroll gallery.
  • Step 5.4: Git commit all changes cleanly.