91 lines
5.7 KiB
Markdown
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.
|