Files
webb/docs/superpowers/plans/2026-11-04-homepage-ui-overhaul.md
T

5.5 KiB
Raw Blame History

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 via next/font/google, define SF Pro fallback, mount SmoothCursor)
  • Modify: tailwind.config.ts (Register font-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_EDITOR via syncEngine.ts

Tasks

  • Task 1: Fonts & Global Styling Setup

    • Update src/app/layout.tsx to load Poppins and Inter from next/font/google, configure SF Pro font stack.
    • Update tailwind.config.ts with the new font families.
    • Verify build and font classes.
  • Task 2: Build MagicUI Core UI Components

    • Implement src/components/magicui/text-animate.tsx supporting slideLeft, fadeIn, blurIn, scaleUp by character and word.
    • Implement src/components/magicui/marquee.tsx with bidirectional infinite scroll and fade masks.
    • Implement src/components/magicui/bento-grid.tsx with responsive layout and spotlight hover.
    • Implement src/components/magicui/smooth-cursor.tsx with spring physics and link detection.
    • Mount SmoothCursor in src/app/layout.tsx.
  • Task 3: Navbar Home Button

    • Update src/components/ui/Navbar.tsx to include an explicit "Home" button/link with active route detection.
  • Task 4: Hero Section (Minimalist + Interactive 3D Background Visuals)

    • Update HeroSection.tsx so the frontpage view features only the animated heading, subheading, and interactive 3D visuals behind the text.
  • 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.
  • Task 6: Trendy Effects Bento Grid Section

    • Implement TrendyBentoSection.tsx with custom rows, columns, and dynamic effects cards using BentoGrid and BentoCard.
  • Task 7: Recommended Apps Section

    • Implement RecommendedAppsSection.tsx featuring the 4 dedicated mobile apps with ratings, platform badges, and direct links.
  • Task 8: How It Works 3D Animation Section

    • Implement HowItWorks3DSection.tsx with 3D canvas showing card upload, scanning laser processing, and 4K output generation.
  • Task 9: Reviews Marquee Section

    • Implement ReviewsMarqueeSection.tsx with dual-direction infinite marquee showcasing verified user reviews.
  • 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.json and content/pages/home.json with the complete ordered section list.
    • Verify page render on Next.js server.
  • 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).