ui-ux-pro-max

What this skill does

# UI/UX Pro Max

## Overview

A comprehensive UI/UX design intelligence system that combines visual design expertise with engineering rigor. This skill provides opinionated, production-ready guidance covering style selection, color palettes, typography, UX heuristics, data visualization, and multi-stack implementation. Every recommendation is filtered through a strict priority hierarchy that ensures accessibility and performance are never sacrificed for aesthetics.

## Phase 1: Requirements Gathering

1. Identify the product type and target audience
2. Determine platform(s) (web, mobile, desktop)
3. Assess existing brand guidelines or design system
4. Define accessibility requirements
5. Set performance budgets

**STOP — Confirm requirements with user before making design recommendations.**

### Priority Hierarchy (Non-Negotiable Order)

Do NOT skip or reorder these priorities. Accessibility always comes first.

1. **Accessibility** — WCAG 2.1 AA minimum, AAA preferred
   - Contrast ratio: 4.5:1 for normal text, 3:1 for large text
   - Keyboard navigation: all interactive elements focusable, visible focus ring
   - ARIA labels on all non-text controls
   - Screen reader announcements for dynamic content
   - Reduced motion: respect `prefers-reduced-motion`
2. **Touch Targets** — 44x44px minimum (Apple HIG / WCAG 2.5.5)
   - Spacing between targets: minimum 8px
   - Clickable area may exceed visual bounds via padding
3. **Performance**
   - Images: WebP with AVIF fallback, lazy loading below fold
   - CLS < 0.1, LCP < 2.5s, FID < 100ms
   - Font loading: `font-display: swap`, preload critical fonts
   - Bundle: code-split routes, tree-shake unused components
4. **Style** — Applied only after 1-3 are satisfied
5. **Layout** — Composition and spacing applied last

## Phase 2: Style Selection

**STOP — Present style recommendation with rationale before proceeding to implementation.**

### Style Selection Decision Table

| Context | Recommended Styles | Why |
|---|---|---|
| SaaS Dashboard | Minimalism, Swiss, Material 3 | Clean, data-focused, professional |
| Portfolio | Brutalism, Maximalism, Glassmorphism | Expressive, memorable |
| E-commerce | Clean, Material 3, Swiss | Trust, clarity, conversion |
| Mobile App | Material 3, Neumorphism, Minimalism | Native feel, thumb-friendly |
| Landing Page | Glassmorphism, Neo-Brutalism, Japandi | Visual impact, hero focus |
| Enterprise/B2B | Swiss Design, Minimalism | Authority, information density |
| Creative Agency | Maximalism, Brutalism, Cyberpunk | Uniqueness, portfolio showcase |
| Health/Wellness | Japandi, Minimalism | Calming, trustworthy |
| Finance | Swiss, Material 3 | Conservative, professional |
| Kids/Family | Claymorphism, Maximalism | Playful, engaging |

### Style Reference (Key Categories)

**Glass and Transparency:**
- Glassmorphism: `backdrop-filter: blur(10px)`, semi-transparent backgrounds, subtle border
- Frosted Glass: heavier blur (20px+), lower opacity, works on busy backgrounds
- Acrylic (Fluent Design): noise texture overlay + blur

**Minimal and Clean:**
- Minimalism: maximum whitespace, single accent color, limited element count
- Swiss Design: grid-based, Helvetica/Grotesk, asymmetric balance
- Japandi: warm neutrals, organic shapes, hidden complexity

**Bold and Expressive:**
- Brutalism: raw, exposed structure, system fonts, harsh borders, no border-radius
- Neo-Brutalism: brutalism + bright accent colors + drop shadows
- Maximalism: layered textures, mixed fonts, dense information

**Depth and Dimension:**
- Neumorphism: soft inner/outer shadows on same-color backgrounds
- Material Design 3: elevation tokens, tonal surfaces, dynamic color
- Claymorphism: inflated 3D look, pastel colors, inner shadows

**Dark and Moody:**
- Dark Mode: OLED-safe (#000 backgrounds), muted primaries, reduced brightness
- Cyberpunk: neon on dark, glitch effects, monospace accents
- Noir: high contrast, grayscale with single accent

## Phase 3: Color and Typography

**STOP — Present palette and font pairing for approval before building components.**

### Color Palette Selection Rules

| Palette Category | Product Types | Characteristics |
|---|---|---|
| SaaS/B2B (24 palettes) | Dashboards, admin tools | Professional blues, teals, slates |
| E-commerce (20 palettes) | Shops, marketplaces | Warm, trust-building ambers, greens |
| Health/Wellness (18 palettes) | Health apps, meditation | Calming greens, soft blues, lavender |
| Finance (15 palettes) | Banking, trading | Deep blues, golds, conservative neutrals |
| Creative (22 palettes) | Portfolios, agencies | Bold, saturated, unexpected combos |
| Social (16 palettes) | Communities, social apps | Vibrant, energetic, gradient-friendly |
| Education (14 palettes) | Learning, courses | Friendly, approachable, moderate saturation |
| Enterprise (12 palettes) | Corporate tools | Muted, authoritative, high-contrast |
| Kids/Family (10 palettes) | Children's apps | Bright primaries, rounded, playful |
| Luxury (10 palettes) | Premium brands | Black, gold, minimal, high whitespace |

### Color Token Rules

- Primary: brand identity color, used for CTAs and key actions
- Secondary: complementary, used for secondary actions and accents
- Neutral: gray scale for text, borders, backgrounds (minimum 9 shades)
- Semantic: success (#22C55E), warning (#F59E0B), error (#EF4444), info (#3B82F6)
- Always define as semantic tokens: `--color-action-primary`, not `--color-blue-500`

### Dark Mode Palette Rules

| Rule | Implementation |
|---|---|
| Do NOT invert colors | Remap to dark-appropriate equivalents |
| Reduce saturation 10-20% | Prevent eye strain on dark backgrounds |
| Elevation = lighter surface | Not shadow-based like light mode |
| Text hierarchy | #E2E8F0 (primary), #94A3B8 (secondary), #64748B (tertiary) |

### Font Pairings (Top 10)

| Pairing | Best For |
|---|---|
| Inter + Source Serif 4 | SaaS, dashboards |
| Geist + Geist Mono | Developer tools, technical |
| DM Sans + DM Serif Display | Marketing, editorial |
| Plus Jakarta Sans + Lora | Modern professional |
| Outfit + Newsreader | Creative agencies |
| Manrope + Bitter | Enterprise applications |
| Space Grotesk + Space Mono | Tech startups |
| Satoshi + Erode | Premium/luxury |
| General Sans + Gambetta | Editorial/publishing |
| Cabinet Grotesk + Zodiak | Bold branding |

### Typography Scale (Default)

```
--text-xs: 0.75rem / 1rem
--text-sm: 0.875rem / 1.25rem
--text-base: 1rem / 1.5rem
--text-lg: 1.125rem / 1.75rem
--text-xl: 1.25rem / 1.75rem
--text-2xl: 1.5rem / 2rem
--text-3xl: 1.875rem / 2.25rem
--text-4xl: 2.25rem / 2.5rem
```

## Phase 4: UX Guidelines Application

### Navigation Rules

1. Primary navigation: maximum 7 items (Miller's Law)
2. Current location always indicated (breadcrumb or active state)
3. Back button must always work as expected
4. Search available on every page for content-heavy apps

### Form Rules

5. Labels above inputs, never placeholder-only
6. Inline validation on blur, not on keystroke
7. Error messages: specific, actionable, adjacent to field
8. Auto-focus first field on page load
9. Submit button disabled until form valid (with explanation)
10. Progress indicator for multi-step forms

### Feedback Rules

11. Loading states for any action > 300ms
12. Skeleton screens over spinners for content loading
13. Toast notifications: auto-dismiss success (3s), persist errors
14. Tap feedback: 80-150ms response time
15. Optimistic UI for low-risk actions

### Content Layout Rules

16. F-pattern for text-heavy pages
17. Z-pattern for landing pages
18. Above-the-fold: value proposition + primary CTA
19. One primary CTA per viewport

### Mobile Rules

20. Bottom navigation for primary actions (thumb zone)
21. Pull-to-refresh for feed content
22. Swipe gestures with visual affordance

## Phase 5: Implementation

### Chart Type Selection Decision Table

| Data Relationship | Chart Types |
|---|---|
| Comparison | Bar, Grouped Bar, Lollipop, Dot Plot |
| Trend over Ti