5.5 KiB
Homepage Complete UI Overhaul Implementation Plan
For agentic workers: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (
- [ ]) syntax for tracking.
This plan details the complete UI transformation of the homepage in WEBB (and synchronized with WEBB_EDITOR), implementing all 11 user requirements with MagicUI animations, SF Pro/Poppins/Inter typography, 2x4 expandable shifting tools grid, Bento Grid, 3D How-It-Works visualizer, Marquee reviews, Smooth Cursor, and updating management/pages/home/page.config.json.
Proposed Changes & File Architecture
1. Typography & Global Styles
- Modify:
src/app/layout.tsx(Load Poppins & Inter vianext/font/google, define SF Pro fallback, mountSmoothCursor) - Modify:
tailwind.config.ts(Registerfont-sans,font-display,font-poppins,font-sf) - Modify:
src/app/globals.css(Font variables, smooth cursor styles, bento & marquee keyframes)
2. MagicUI Core Components
- Create:
src/components/magicui/text-animate.tsx(MagicUI TextAnimate with character/word/line animations) - Create:
src/components/magicui/bento-grid.tsx(MagicUI BentoGrid & BentoCard with spotlight/beam) - Create:
src/components/magicui/marquee.tsx(MagicUI Marquee infinite scrolling component) - Create:
src/components/magicui/smooth-cursor.tsx(Spring-interpolated custom cursor)
3. Top Navigation
- Modify:
src/components/ui/Navbar.tsx(Add dedicated Home button/link with active styling)
4. Homepage Sections
- Create/Modify:
src/components/sections/HeroSection.tsx(Clean hero viewport with heading, subheading, and interactive 3D WebGL background visuals) - Create:
src/components/sections/ShiftableToolsGridSection.tsx(2 rows × 4 columns, rounded windows, photo/video/comparison slider, horizontal shift/expansion on hover, title below, See More button) - Create:
src/components/sections/TrendyBentoSection.tsx(Bento Grid displaying trendy effects) - Create:
src/components/sections/RecommendedAppsSection.tsx(Dedicated showcase of mobile apps) - Create:
src/components/sections/HowItWorks3DSection.tsx(3D animation of image upload -> neural scan -> 4K output return) - Create:
src/components/sections/ReviewsMarqueeSection.tsx(Infinite marquee with customer reviews) - Modify:
src/components/sections/SectionRenderer.tsx(Wire up new section types)
5. Content & Management Sync
- Modify:
management/pages/home/page.config.json(Structured with new sections) - Modify:
content/pages/home.json(Mirror configuration) - Sync to:
WEBB_EDITORviasyncEngine.ts
Tasks
-
Task 1: Fonts & Global Styling Setup
- Update
src/app/layout.tsxto loadPoppinsandInterfromnext/font/google, configureSF Profont stack. - Update
tailwind.config.tswith the new font families. - Verify build and font classes.
- Update
-
Task 2: Build MagicUI Core UI Components
- Implement
src/components/magicui/text-animate.tsxsupportingslideLeft,fadeIn,blurIn,scaleUpby character and word. - Implement
src/components/magicui/marquee.tsxwith bidirectional infinite scroll and fade masks. - Implement
src/components/magicui/bento-grid.tsxwith responsive layout and spotlight hover. - Implement
src/components/magicui/smooth-cursor.tsxwith spring physics and link detection. - Mount
SmoothCursorinsrc/app/layout.tsx.
- Implement
-
Task 3: Navbar Home Button
- Update
src/components/ui/Navbar.tsxto include an explicit "Home" button/link with active route detection.
- Update
-
Task 4: Hero Section (Minimalist + Interactive 3D Background Visuals)
- Update
HeroSection.tsxso the frontpage view features only the animated heading, subheading, and interactive 3D visuals behind the text.
- Update
-
Task 5: Shiftable Tools Grid (2 Rows × 4 Columns)
- Implement
ShiftableToolsGridSection.tsx:- 2 rows × 4 columns (8 tools: blemish-remover, background-remover, photo-enhancer, old-photo-restorer, colorization, teeth-whitener, cartoon-avatar, polaroid-maker).
- Windows support 3 media types: image, looping video, or animated comparison slider.
- Hover effect: hovered window horizontally expands while shifting adjacent ones sideways.
- Minimal title below each window.
- Clicking opens
/tools/[slug]. - Includes "See more tools" button redirecting to
/tools.
- Implement
-
Task 6: Trendy Effects Bento Grid Section
- Implement
TrendyBentoSection.tsxwith custom rows, columns, and dynamic effects cards usingBentoGridandBentoCard.
- Implement
-
Task 7: Recommended Apps Section
- Implement
RecommendedAppsSection.tsxfeaturing the 4 dedicated mobile apps with ratings, platform badges, and direct links.
- Implement
-
Task 8: How It Works 3D Animation Section
- Implement
HowItWorks3DSection.tsxwith 3D canvas showing card upload, scanning laser processing, and 4K output generation.
- Implement
-
Task 9: Reviews Marquee Section
- Implement
ReviewsMarqueeSection.tsxwith dual-direction infinite marquee showcasing verified user reviews.
- Implement
-
Task 10: Register New Sections in SectionRenderer & Update Management Config
- Wire all new sections into
src/components/sections/SectionRenderer.tsx. - Update
management/pages/home/page.config.jsonandcontent/pages/home.jsonwith the complete ordered section list. - Verify page render on Next.js server.
- Wire all new sections into
-
Task 11: Sync WEBB_EDITOR & Full System Verification
- Run sync engine to update
WEBB_EDITOR. - Run test suite (
npm test). - Verify Next.js production build (
npm run build).
- Run sync engine to update