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

3.9 KiB

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.