Files
webb/docs/superpowers/plans/2026-11-04-management-folder-and-refined-ux.md
T

5.7 KiB

Management Folder Architecture & Refined Visual UX Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

This plan resolves four core user requirements:

  1. Centralized Management Folder (management/): Modular, page-by-page folder architecture housing all JSON configs and media (before/after images, banners, videos), allowing direct file-drop replacement for live website updates.
  2. Tool Page Re-engineering (/tools/[slug]): Spacious prominent upload studio, borderless result-focused display stage, typography placed outside cards, and a generative latent grain transformation animation.
  3. Homepage Tool Stack Cards Hover-Only Slide: Eliminate simultaneous chaotic auto-sliding across all 8 cards; only animate the card that is actively hovered, and allow click/drag to manually inspect.
  4. Fluid, Seamless Horizontal Scroll: Fix sticky overflow constraints (overflow-x: clip), smooth scroll conflicts, and ensure frictionless progression from vertical -> horizontal -> vertical.

File Structure & Responsibilities

management/
├── pages/
│   ├── home/
│   │   ├── page.config.json          # Home page section configuration & copy
│   │   └── media/                    # Media assets used on home page
│   └── tools/
│       ├── cartoon-avatar/
│       │   ├── tool.config.json      # Tool metadata, copy, displayType ("beforeAfter" | "banner")
│       │   └── media/                # before.jpg, after.jpg, sample-*.jpg
│       ├── blemish-remover/
│       ├── background-remover/
│       ├── colorization/
│       ├── old-photo-restorer/
│       ├── photo-enhancer/
│       ├── polaroid-maker/
│       └── teeth-whitener/
public/
└── management -> symlink or synced to ../management
src/
├── components/
│   ├── ui/
│   │   ├── NeuralGrainOverlay.tsx    # Generative AI latent grain transform animation
│   │   ├── CardBeforeAfterSlider.tsx # Tool stack card slider (hover-only slide, click-drag)
│   ├── sections/
│   │   ├── HeroSection.tsx           # Redesigned tool hero (prominent upload, result-focused display)
│   │   ├── TryItWidget.tsx           # Spacious, beautiful upload studio
│   │   ├── CinematicHorizontalScrollSection.tsx # Frictionless horizontal showcase
├── lib/
│   ├── config/
│   │   ├── loader.ts                 # Loads configurations and media paths from management/

Tasks

Task 1: Create Centralized management/ Folder Architecture

  • Create management/pages/tools/[slug]/ directories for all 8 tools with tool.config.json and media/ subdirectories.
  • Copy or generate high-res before/after assets into management/pages/tools/[slug]/media/before.jpg and after.jpg.
  • Create management/pages/home/ with page.config.json and media/.
  • Ensure Next.js can serve assets from management/ via symlink in public/management or Next route so replacing any file immediately updates the live site.
  • Update src/lib/config/loader.ts to source tool data and media paths from management/.
  • Verify npm test and build compile cleanly.

Task 2: Home Page Tool Stack Cards — Hover-Only Sliding

  • Update src/components/ui/CardBeforeAfterSlider.tsx:
    • Static 50% rest state when not hovered.
    • Start smooth, gentle slide animation only when cursor is hovering over the card.
    • Clicking/dragging allows manual scrub.
    • Reset to rest on mouse leave.
  • Verify all cards remain calm and static until hovered.

Task 3: Tool Landing Page (/tools/[slug]) Visual Redesign & Grain Transform Animation

  • Create src/components/ui/NeuralGrainOverlay.tsx:
    • Authentic generative AI latent grain / noise sweep animation representing neural model synthesis.
    • Canvas/SVG-based high-frequency grain texture with customizable intensity and scan sweep.
  • Redesign src/components/sections/HeroSection.tsx (variant === 'toolHero'):
    • Typography placed outside cards: Large editorial headline, category badge, and descriptive copy directly on page background.
    • Left / Display Stage: Focus 100% on actual transformation results with minimal border chrome, integrated Before/After slider, and the Neural Grain transformation effect.
    • Right / Upload Studio: Spacious, prominent, high-end upload dropzone with glowing borders, clear specs, and sample presets.
  • Update src/components/sections/TryItWidget.tsx to match the spacious, beautiful studio layout.

Task 4: Fix Horizontal Showcase Scroll Fluidity

  • Fix body overflow in src/app/globals.css: replace overflow-x: hidden with overflow-x: clip so position: sticky is never disabled.
  • In CinematicHorizontalScrollSection.tsx, ensure synchronous DOM transform updates on scroll with liquid GPU hardware acceleration.
  • Ensure arrow navigation, wheel scrolling, and trackpad swipe glide seamlessly through all cards and transition cleanly to the next section.

Task 5: Verification & End-to-End Testing

  • Run npm test to verify all unit tests pass.
  • Run headless browser script verifying:
    • Tool cards in "Find the right tool fast" slide ONLY on hover.
    • Tool specific page renders prominent upload studio + grain transformation display + typography outside cards.
    • Horizontal scroll glides seamlessly.
    • Replacing an image in management/ updates the live page.
  • Commit all changes to git.