Files
webb/docs/superpowers/plans/2026-11-03-complete-ui-overhaul.md
T

208 lines
11 KiB
Markdown

# CRE Innovations Complete UI Overhaul 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.
**Goal:** Complete visual, architectural, and aesthetic overhaul of the CRE Innovations photo tools web application, delivering an ultra-luxurious dark obsidian neo-studio design, bespoke SVG brand logo, high-end typography and animations, and an interactive category-wise vertical tools stack section.
**Architecture:** Next.js 14 App Router, TypeScript, Tailwind CSS with extended design tokens (obsidian shadows, neon glows, laser borders, glassmorphism), CSS keyframe animation suite, SVG brand assets, and dynamic React components driven by `content/*.json`.
**Tech Stack:** Next.js 14.2, React 18, TypeScript, Tailwind CSS, Lucide React, Google Fonts (`Outfit`, `Plus_Jakarta_Sans`, `JetBrains_Mono`), HTML5 Canvas.
**Spec:** User prompt: "complete ui overhaul of this , make this ultra beautiful ui , best fonts and typography, colors, animation, a vertical tools stack section with category wise tools , best logo, everything should be completely overhauled".
---
## Global Constraints
- Brand name: strictly **CRE Innovations** across all pages, titles, copy, and logos.
- Zero hardcoded tool metadata: driven dynamically by `content/collections/tools/*.json` and `content/site.config.json`.
- Responsiveness: pixel-perfect layout from 320px mobile up to 1920px+ desktop displays.
- SEO & Accessibility: 100% semantic HTML, zero missing image alt tags, valid Schema.org JSON-LD, WCAG AA contrast.
- Zero-Storage & Proxy: preserve binary streaming RAM proxy `/api/try/[toolId]` with server-side secret validation intact.
## Review Focus
1. **Vertical Tools Stack Interaction**: Smooth sticky category sidebar navigation with active highlight on desktop, fluid horizontal chip scroll on mobile.
2. **Interactive Before/After Sliders**: Silky drag handle responsiveness inside vertical stack cards without horizontal page scroll lock.
3. **High-Performance Animations**: Hardware-accelerated GPU animations (`transform`, `opacity`, `filter: blur`) ensuring 60fps rendering without jank.
4. **Legibility & Contrast**: High-contrast typographic hierarchy ensuring all sub-copy and badges are readable against dark obsidian glass.
5. **Brand Polish**: Precision vector geometry for CRE Innovations logo across header, footer, favicon, and social meta.
---
### Task 1: Design Tokens, Typography, and Animation Engine
**Files:**
- Modify: `tailwind.config.ts`
- Modify: `src/app/globals.css`
- Modify: `src/app/layout.tsx`
**Interfaces:**
- Produces: CSS custom properties `--font-sans`, `--font-display`, `--font-mono`, color tokens (`obsidian`, `void`, `neon-cyan`, `electric-violet`, `emerald-beam`), glassmorphism utility classes (`.glass-neo`, `.laser-border`, `.glow-cyan`, `.glow-violet`, `.mesh-ambient`).
- [ ] **Step 1: Update Tailwind Config with Neo-Studio Tokens**
- Add colors: obsidian shades (`#05070B`, `#0B0E14`, `#121722`, `#1B2232`), neon cyan (`#00F0FF`), electric violet (`#7928CA`), laser pink (`#FF0080`), emerald beam (`#10B981`).
- Add box shadow glows (`shadow-glow-cyan`, `shadow-glow-violet`, `shadow-laser`).
- Add custom animations (`float`, `pulse-glow`, `shimmer-slide`, `border-beam`, `marquee-smooth`).
- [ ] **Step 2: Enhance `globals.css` with Advanced Visual FX**
- Define radial ambient background meshes, hairline border beam animations, ultra-smooth scrollbars, and glass frosted backdrop styles.
- [ ] **Step 3: Integrate Monospace & Refined Google Fonts in `layout.tsx`**
- Configure `Outfit` (display), `Plus_Jakarta_Sans` (body), and `JetBrains_Mono` (stats & code) with optical font-feature settings.
- [ ] **Step 4: Verify Compilation & Style System**
- Run build validation to confirm Tailwind compiles without errors.
- [ ] **Step 5: Commit Design Tokens**
- `git commit -m "feat(ui): upgrade design tokens, typography, and animation engine"`
---
### Task 2: Bespoke Vector Brand Logo & Navigation Overhaul
**Files:**
- Create: `src/components/ui/BrandLogo.tsx`
- Create: `public/brand/logo.svg`
- Create: `public/brand/icon.svg`
- Modify: `src/components/ui/Navbar.tsx`
- Modify: `src/components/ui/Footer.tsx`
**Interfaces:**
- Consumes: Site config (`brand.name`, `nav.primary`, `nav.actions`).
- Produces: `<BrandLogo size="sm" | "md" | "lg" showWordmark={boolean} />` component with precision SVG neural aperture & geometric chrome gradients.
- [ ] **Step 1: Create Custom SVG Brand Assets**
- Precision vector neural prism aperture: intersecting crystalline lens facets with cyan-to-violet gradient strokes, central radiant focal node, and modern typographic "CRE INNOVATIONS" wordmark.
- Export standalone `public/brand/logo.svg` and `public/brand/icon.svg`.
- [ ] **Step 2: Implement `<BrandLogo />` Component**
- Support flexible sizing, animated pulse glow on hover, and dark/light adaptive fills.
- [ ] **Step 3: Rebuild `Navbar.tsx` with Floating Neo-Glass Capsule**
- Floating pill container with frosted backdrop blur (`backdrop-blur-xl`), hairline laser border, category quick-jump anchors, live indicator badge ("● Core v2.4 Live"), and mobile drawer.
- [ ] **Step 4: Rebuild `Footer.tsx` with Architectural Layout**
- 4-column studio layout, live uptime status pill (99.98% Neural Core), Zero-Storage cryptographic guarantee badge, legal links, and copyright.
- [ ] **Step 5: Commit Brand & Navigation**
- `git commit -m "feat(brand): bespoke CRE Innovations vector logo and neo-glass navigation"`
---
### Task 3: Category-Wise Vertical Tools Stack Section
**Files:**
- Create: `src/components/sections/VerticalToolStackSection.tsx`
- Modify: `src/components/sections/SectionRenderer.tsx`
- Modify: `content/pages/home.json`
- Modify: `content/pages/tools.json`
**Interfaces:**
- Consumes: `tools: ToolConfig[]`, `categories: CategoryConfig[]`, `context: SectionContext`.
- Produces: Interactive vertical stack layout grouping tools by category (Portrait Retouching, Vision & Restoration, Studio Cutouts, Creative Effects) with sticky category selector on desktop and horizontal chip rail on mobile.
- [ ] **Step 1: Create `VerticalToolStackSection.tsx` Component**
- Group tools by category dynamically from `content/categories.json`.
- Left column (Desktop): Sticky navigation panel showing category names, icons, tool counts, and smooth scroll anchor links with active highlighting.
- Right column: Vertical stack of premium tool cards.
- Card specifications:
- Glowing category tag + Neural engine badge (e.g. `P3M-Matting Core`, `GFPGAN v1.4`).
- Tool title, punchy value proposition, and latency metric (`< 450ms`).
- Integrated before/after comparison preview with interactive split slider.
- Quick action buttons: "Launch in Browser" (opens TryIt or navigates to `/tools/[slug]`) and "Open in App" pill.
- Mobile responsiveness: sticky top swipeable category pills that snap to corresponding category stacks.
- [ ] **Step 2: Register Section in `SectionRenderer.tsx`**
- Map section type `verticalToolStack` to `VerticalToolStackSection`.
- [ ] **Step 3: Update `home.json` and `tools.json`**
- Insert `verticalToolStack` into `content/pages/home.json` in prominent position.
- [ ] **Step 4: Test Interactive Stacking & Sliders**
- Verify slider touch/drag works smoothly on both desktop and mobile viewports.
- [ ] **Step 5: Commit Vertical Tool Stack**
- `git commit -m "feat(tools): add category-wise vertical tools stack with interactive sliders"`
---
### Task 4: Hero Section & TryIt Widget Neo-Studio Redesign
**Files:**
- Modify: `src/components/sections/HeroSection.tsx`
- Modify: `src/components/sections/TryItWidget.tsx`
- Modify: `src/components/ui/BeforeAfterSlider.tsx`
**Interfaces:**
- Consumes: Tool configs, sample images, API proxy `/api/try/[toolId]`.
- Produces: Next-generation interactive hero with floating studio badges, live before/after interactive demonstration, high-impact gradient typography, and frictionless 1-click test presets.
- [ ] **Step 1: Redesign `HeroSection.tsx`**
- Radiant background beam with animated cosmic dust / grid mesh.
- High-impact headline with chromatic gradient clip ("Transform Photos with Next-Gen Neural AI").
- Studio pill badges: "⚡ CRE Neural Vision Core v2.4 Live", "🔒 100% In-Memory RAM Streaming".
- Quick action CTA group with instant scroll to tools and native app links.
- [ ] **Step 2: Overhaul `TryItWidget.tsx`**
- Elevated glass container with animated border glow.
- One-click sample preset selector (Portrait Blemish, P3M Hair Matting, 4K Face Restore, Vintage Colorization).
- Neural processing indicator with animated radar pulse and processing timer.
- High-definition before/after inspector with 1-click HD download.
- [ ] **Step 3: Polish `BeforeAfterSlider.tsx`**
- Smooth glass divider handle with bidirectional arrows and subtle neon cyan glow.
- Touch-action optimization to prevent mobile scroll conflicts.
- [ ] **Step 4: Commit Hero & Widget Overhaul**
- `git commit -m "feat(hero): overhaul hero and interactive try-it widget with neo-studio aesthetics"`
---
### Task 5: Supporting Sections Visual Polish (Reel, Use Cases, Pipeline, Handoff)
**Files:**
- Modify: `src/components/sections/TransformationReelSection.tsx`
- Modify: `src/components/sections/VisualUseCasesSection.tsx`
- Modify: `src/components/sections/WorkflowVisualizerSection.tsx`
- Modify: `src/components/sections/AppHandoffSection.tsx`
- Modify: `src/components/sections/StatsSection.tsx`
**Interfaces:**
- Consumes: JSON config sections.
- Produces: Polished interactive components consistent with the new neo-studio visual language.
- [ ] **Step 1: Upgrade `TransformationReelSection.tsx`**
- Infinite smooth marquee with laser border container, iridescent badges, and dual-state image cards.
- [ ] **Step 2: Upgrade `VisualUseCasesSection.tsx`**
- 4 commercial photography use case cards with glass depth, category tags, before/after hover reveals, and capability metrics.
- [ ] **Step 3: Upgrade `WorkflowVisualizerSection.tsx`**
- 3-step pipeline with glowing animated SVG connector cables and zero-storage cryptographic verification badge.
- [ ] **Step 4: Upgrade `AppHandoffSection.tsx` & `StatsSection.tsx`**
- Dynamic QR code with branded logo overlay, copy-paste promo code button (`TRYWEB50`), and high-impact stat counters.
- [ ] **Step 5: Commit Supporting Sections**
- `git commit -m "feat(ui): overhaul reel, use-cases, pipeline, and app handoff sections"`
---
### Task 6: Comprehensive Verification & Build Audit
**Files:**
- Audit all pages (`/`, `/tools`, `/tools/[slug]`, `/apps`, `/apps/[slug]`, `/pricing`, `/trust`)
- Test responsive viewports: 375px (mobile), 768px (tablet), 1280px (laptop), 1920px (desktop)
- Verify Puppeteer headless browser checks and SEO JSON-LD integrity
- [ ] **Step 1: TypeScript and Production Build Verification**
- Run `npm run build` to confirm zero compilation or lint errors.
- [ ] **Step 2: Launch Production Server & Verify Pages**
- Start server and run automated curl / Puppeteer tests across all routes.
- [ ] **Step 3: Check Schema.org JSON-LD and SEO Meta**
- Ensure zero missing alt tags, valid Organization, WebSite, and FAQPage schemas.
- [ ] **Step 4: Final Git Commit and Status Summary**
- Clean commit on `main` branch.