# 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.