92 lines
5.8 KiB
Markdown
92 lines
5.8 KiB
Markdown
# 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.
|
|
|
|
---
|
|
|
|
### Task 3: Build `CinematicHorizontalScrollSection.tsx` (Scroll-Driven Horizontal Motion Gallery)
|
|
|
|
**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.
|