69 lines
3.9 KiB
Markdown
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.
|