5.7 KiB
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:
- 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. - 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. - 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.
- 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 withtool.config.jsonandmedia/subdirectories. - Copy or generate high-res before/after assets into
management/pages/tools/[slug]/media/before.jpgandafter.jpg. - Create
management/pages/home/withpage.config.jsonandmedia/. - Ensure Next.js can serve assets from
management/via symlink inpublic/managementor Next route so replacing any file immediately updates the live site. - Update
src/lib/config/loader.tsto source tool data and media paths frommanagement/. - Verify
npm testand 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.tsxto match the spacious, beautiful studio layout.
Task 4: Fix Horizontal Showcase Scroll Fluidity
- Fix
bodyoverflow insrc/app/globals.css: replaceoverflow-x: hiddenwithoverflow-x: clipsoposition: stickyis 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 testto 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.