Files
webb/docs/superpowers/plans/2026-11-03-3d-motion-graphics-neural-prism.md
T

69 lines
3.9 KiB
Markdown

# 3D Motion Graphics & Neural Prism Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** Elevate the CRE Innovations front page with interactive Three.js 3D motion graphics, perspective card tilt, specular reflections, and kinetic telemetry inspired by Squared Media (squared-media.nl), while ensuring zero SEO degradation and ultra-fast 60fps performance.
**Architecture:**
- A lightweight, lazy-loaded Three.js WebGL canvas (`Hero3DCanvas`) rendering a 3D neural crystal prism and particle constellation with inertial mouse tracking, paused via `IntersectionObserver` when offscreen.
- A high-performance 3D perspective tilt component (`TiltCard`) with dynamic specular glare overlay.
- An ambient desktop cursor aura follower (`CursorAura`) delivering agency-grade polish.
- Full preservation of semantic HTML, Schema.org JSON-LD, and zero impact on Core Web Vitals or mobile responsiveness.
**Tech Stack:** Next.js 14 (App Router), React 18, Three.js (`three` + `@types/three`), Tailwind CSS, Lucide React.
---
## Global Constraints
- Brand name: strictly **CRE Innovations**.
- Palette: Light creamy off-white (`#FAF8F5` / `#F5F2EB`) with slate-900 typography and electric neural blue/indigo accents.
- Zero SEO degradation: All H1/H2/H3/p tags, Schema.org structured data, and meta tags must remain intact; 3D canvas is `aria-hidden="true"` and non-blocking.
- Ultra-fast & lightweight: Canvas uses DPR clamp <= 2, pauses RAF when out of viewport, and disposes WebGL resources on unmount.
- Python commands: Use `/home/creserver/extras/local_venv/bin/python` per user global rule.
---
## Task Decomposition
### Task 1: Create `Hero3DCanvas.tsx`
- File: `src/components/3d/Hero3DCanvas.tsx`
- Build Three.js 3D neural crystal (icosahedron wireframe + inner glowing sphere + 60 floating neural particles).
- Implement smooth lerp mouse tracking `(targetX, targetY)`.
- Implement `IntersectionObserver` to halt RAF loop when canvas is not visible.
- Add full WebGL resource disposal on unmount.
### Task 2: Create `TiltCard.tsx` and `CursorAura.tsx`
- File: `src/components/ui/TiltCard.tsx`
- Mouse move perspective tilt (`perspective(1000px) rotateX(...) rotateY(...) scale3d(1.01, 1.01, 1.01)`).
- Dynamic radial specular highlight layer.
- Smooth spring reset on mouse leave.
- Respects `prefers-reduced-motion` and touch devices.
- File: `src/components/ui/CursorAura.tsx`
- Desktop-only ambient radial glow follower (`@media(hover:hover)`).
- RAF lerp smoothing.
### Task 3: Integrate 3D Motion Graphics into `HeroSection.tsx`
- File: `src/components/sections/HeroSection.tsx`
- Dynamically import `Hero3DCanvas` with `{ ssr: false }`.
- Position the 3D canvas behind/beside the hero headline with subtle atmospheric glow.
- Add kinetic floating telemetry chips (`⚡ CRE Neural Core v2.4`, `In-Memory ~340ms`, `Zero Disk Storage Active`) with staggered orbital float.
- Wrap TryItWidget in `TiltCard`.
### Task 4: Enhance Flagship Banners and Studio Suite with 3D Tilt
- Files:
- `src/components/sections/MajorToolBannersSection.tsx`
- `src/components/sections/VerticalToolStackSection.tsx`
- Wrap flagship cards and studio suite cards in `TiltCard` with subtle specular gleam.
### Task 5: Global Layout Integration & Styling
- File: `src/app/layout.tsx`
- Mount `CursorAura` at body level.
- Add CSS animations for floating telemetry badges in `src/app/globals.css`.
### Task 6: Production Build, Server Restart & Automated Verification
- Run `npm run build` to verify clean compilation without TypeScript or SSR errors.
- Restart production server daemon task (`npm run start`).
- Run Python audit script to verify all 9 routes return 200 OK, 1 H1, 0 missing alt tags.
- Test in Puppeteer: evaluate WebGL canvas rendering, 60fps loop, and card tilt.
- Commit all changes with descriptive commit message.