Files
webb/docs/superpowers/plans/2026-11-03-major-tool-banners-and-animations.md
T

3.6 KiB

Major Tool Banners & Animated Comparisons 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: Eliminate redundant content across pages, implement smooth auto-sliding before/after comparison animations, and create a flagship Major Tool Banners section showcasing flagship AI models in alternating editorial layouts.

Architecture: Next.js 14 App Router, dynamic JSON configs, Canvas/RAF-driven smooth slider oscillation in BeforeAfterSlider.tsx, new MajorToolBannersSection.tsx registered in SectionRenderer.tsx.

Tech Stack: Next.js 14, React 18, TypeScript, Tailwind CSS, Lucide React.


Global Constraints

  • Brand name: strictly CRE Innovations.
  • Color palette: maintain warm, light creamy off-white studio aesthetic (#FAF8F5 / #F5F2EB).
  • Non-redundancy: eliminate duplicate tool grids and duplicate comparison sliders across pages.
  • Auto-sliding animation: smooth sine-wave oscillation that pauses instantly on user touch/mouse interaction.

Task 1: Auto-Sliding Before/After Animation in BeforeAfterSlider.tsx

Files:

  • Modify: src/components/ui/BeforeAfterSlider.tsx

  • Step 1: Implement RAF-based Auto-Slide Oscillation

    • Add autoSlide?: boolean (defaults to true).
    • Use requestAnimationFrame with a smooth sine function (50 + 28 * Math.sin(timestamp * 0.0015)) to oscillate between ~22% and ~78%.
    • On mouse enter / touch start: pause animation immediately and allow manual dragging.
    • On mouse leave: resume after a short grace period.
    • Add mode indicator pill ("Auto-Scanning" / "Manual Inspect").
  • Step 2: Verify component in build

    • Run npm run build to confirm no compilation issues.

Task 2: Create Flagship MajorToolBannersSection.tsx

Files:

  • Create: src/components/sections/MajorToolBannersSection.tsx

  • Modify: src/components/sections/SectionRenderer.tsx

  • Step 1: Build MajorToolBannersSection.tsx

    • Spotlight 3 flagship tools:
      1. P3M-Net Ultra Cutout Studio (Hair-strand isolation & alpha PNG)
      2. RetouchGAN v2.1 Skin Precision (Pore-preserving acne & blemish removal)
      3. GFPGAN + RealESRGAN 4K Enhancer (Super-resolution & vintage deblurring)
    • Alternating layout (Left-Right, Right-Left, Left-Right) for rhythm and aesthetic symmetry.
    • Large-format auto-sliding before/after animation frames.
    • 1-click "Launch Tool Online" and "Get Mobile App" CTAs.
  • Step 2: Register in SectionRenderer.tsx

    • Add case 'majorToolBanners': return <MajorToolBannersSection />.

Task 3: De-duplicate Page Content across JSON Configs

Files:

  • Modify: content/pages/home.json

  • Modify: content/pages/tools.json

  • Step 1: Clean Up home.json

    • Add majorToolBanners section after stats-section.
    • Remove duplicate featured-tools (toolGrid) from homepage (now uniquely represented by The Creative Suite and Flagship Banners).
    • Remove duplicate showcase-before-after (redundant with the animated banners).
  • Step 2: Clean Up tools.json

    • Remove tools-vertical-stack from tools.json so /tools is purely the dedicated search and filter directory (toolGrid), giving each page a distinct role.

Task 4: Comprehensive Verification & Audit

Files:

  • Audit homepage and all subpages

  • Verify clean build, zero TypeScript errors, valid SEO & schemas

  • Step 1: Run npm run build

  • Step 2: Restart Server & Test Routes

  • Step 3: Commit and Final Status