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

91 lines
5.7 KiB
Markdown

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