UI/UX Pro Max - Design Intelligence Expert
Comprehensive UI/UX design guide for web and mobile applications. Provides intelligent design recommendations based on product type, industry, and user requirements. Reference these guidelines when designing new UI, choosing colors and typography, reviewing code for UX issues, or implementing features.
Workflow
Step 1: Analyze User Requirements
Extract from user request:
- Product type: SaaS, e-commerce, portfolio, dashboard, landing page, etc.
- Style keywords: minimal, playful, professional, elegant, dark mode, etc.
- Industry: healthcare, fintech, gaming, education, beauty, etc.
- Tech stack: React, Vue, Next.js, Svelte, Flutter, or html-tailwind (default)
Step 2: Generate Design System
Consult the reference data below (and CSV files in data/) for:
- Recommended patterns and section layouts
- Primary visual style with effects
- Color palette (primary, secondary, CTA, background, text)
- Typography pairing (heading + body fonts with Google Fonts URL)
- Key effects and anti-patterns to avoid
Step 3: Implementation Guidelines
Apply stack-specific best practices from the reference data:
- HTML/Tailwind utilities, responsive breakpoints
- React hooks, state management, performance patterns
- Vue Composition API, Pinia state
- Flutter widgets, themes, navigation
- Accessibility requirements (WCAG compliance)
Step 4: Pre-Delivery Verification
Run through all checklists (visual quality, interaction, light/dark mode, layout, accessibility) before delivering any UI code.
Priority Rules
| Priority |
Category |
Impact |
| 1 |
Accessibility |
CRITICAL - Color contrast 4.5:1, focus states, aria-labels |
| 2 |
Touch & Interaction |
CRITICAL - 44x44px touch targets, cursor-pointer |
| 3 |
Performance |
HIGH - Image optimization, lazy loading |
| 4 |
Layout & Responsive |
HIGH - Mobile-first, viewport meta |
| 5 |
Typography & Color |
MEDIUM - Line height 1.5-1.75, readable fonts |
| 6 |
Animation |
MEDIUM - 150-300ms duration, transform-only |
| 7 |
Style Selection |
MEDIUM - Match style to product type |
Quick Style Selector by Product Type
| Product Type |
Primary Style |
Secondary Styles |
Color Mood |
| SaaS (General) |
Minimalism |
Flat Design, Glassmorphism |
Trust blue + accent contrast |
| E-commerce |
Neo-Brutalism |
Bento Grid, Dark Mode |
Brand primary + success green |
| E-commerce Luxury |
Luxury Minimal |
Dark Mode, Elegant |
Premium black + gold accents |
| Healthcare |
Soft Minimalism |
Flat Design, Organic |
Calm blue + health green |
| Fintech/Crypto |
Cyberpunk |
Dark Mode, Glassmorphism |
Dark tech + vibrant accents |
| Gaming |
Neon Glow |
Cyberpunk, Dark Mode |
Vibrant + neon + immersive |
| Portfolio/Creative |
Editorial |
Brutalism, Asymmetric |
Brand primary + artistic |
| Dashboard |
Corporate Tech |
Flat Design, Data-Dense |
Cool→Hot gradients + neutral |
| AI/Chatbot |
Aurora Gradients |
Glassmorphism, Dark Mode |
Neutral + AI Purple (#6366F1) |
| Beauty/Spa/Wellness |
Organic Shapes |
Soft Minimalism, Elegant |
Soft pastels + natural tones |
Color Palettes by Industry
SaaS / Business
| Role |
Hex |
Tailwind |
| Primary |
#2563EB |
blue-600 |
| Secondary |
#3B82F6 |
blue-500 |
| CTA |
#F97316 |
orange-500 |
| Background |
#F8FAFC |
slate-50 |
| Text |
#1E293B |
slate-800 |
| Border |
#E2E8F0 |
slate-200 |
E-commerce Luxury
| Role |
Hex |
Tailwind |
| Primary |
#1C1917 |
stone-900 |
| Secondary |
#44403C |
stone-700 |
| CTA |
#CA8A04 |
yellow-600 |
| Background |
#FAFAF9 |
stone-50 |
| Text |
#0C0A09 |
stone-950 |
| Border |
#D6D3D1 |
stone-300 |
Healthcare
| Role |
Hex |
Tailwind |
| Primary |
#0891B2 |
cyan-600 |
| Secondary |
#22D3EE |
cyan-400 |
| CTA |
#059669 |
emerald-600 |
| Background |
#ECFEFF |
cyan-50 |
| Text |
#164E63 |
cyan-900 |
| Border |
#A5F3FC |
cyan-200 |
Fintech / Crypto
| Role |
Hex |
Tailwind |
| Primary |
#F59E0B |
amber-500 |
| Secondary |
#FBBF24 |
amber-400 |
| CTA |
#8B5CF6 |
violet-500 |
| Background |
#0F172A |
slate-900 |
| Text |
#F8FAFC |
slate-50 |
| Border |
#334155 |
slate-700 |
Gaming
| Role |
Hex |
Tailwind |
| Primary |
#7C3AED |
violet-600 |
| Secondary |
#A78BFA |
violet-400 |
| CTA |
#F43F5E |
rose-500 |
| Background |
#0F0F23 |
custom-dark |
| Text |
#E2E8F0 |
slate-200 |
| Border |
#4C1D95 |
violet-900 |
AI / Chatbot Platform
| Role |
Hex |
Tailwind |
| Primary |
#7C3AED |
violet-600 |
| Secondary |
#A78BFA |
violet-400 |
| CTA |
#06B6D4 |
cyan-500 |
| Background |
#FAF5FF |
violet-50 |
| Text |
#1E1B4B |
indigo-950 |
| Border |
#DDD6FE |
violet-200 |
Beauty / Spa / Wellness
| Role |
Hex |
Tailwind |
| Primary |
#DB2777 |
pink-600 |
| Secondary |
#F472B6 |
pink-400 |
| CTA |
#059669 |
emerald-600 |
| Background |
#FDF2F8 |
pink-50 |
| Text |
#831843 |
pink-900 |
| Border |
#FBCFE8 |
pink-200 |
Typography Pairings
Professional / Corporate
Heading: Inter | Body: Inter
@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
Best for: SaaS, dashboards, business apps
Elegant / Luxury
Heading: Playfair Display | Body: Lato
@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:wght@500;600;700&family=Lato:wght@400;700&display=swap');
Best for: Luxury brands, editorial, high-end e-commerce
Modern / Tech
Heading: Space Grotesk | Body: DM Sans
@import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@500;600;700&family=DM+Sans:wght@400;500;700&display=swap');
Best for: Tech startups, fintech, AI products
Friendly / Playful
Heading: Poppins | Body: Open Sans
@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@500;600;700&family=Open+Sans:wght@400;600&display=swap');
Best for: Education, consumer apps, lifestyle brands
Editorial / Creative
Heading: Fraunces | Body: Source Sans 3
@import url('https://fonts.googleapis.com/css2?family=Fraunces:wght@500;600;700&family=Source+Sans+3:wght@400;600&display=swap');
Best for: Blogs, magazines, portfolios
Healthcare / Wellness
Heading: Outfit | Body: Nunito
@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@500;600;700&family=Nunito:wght@400;600&display=swap');
Best for: Healthcare, wellness, medical apps
Visual Styles Reference
Minimalism
- Colors: Monochrome + 1 accent, high whitespace
- Effects: Subtle shadows, clean borders, micro-interactions
- Best For: SaaS, productivity, professional apps
- Keywords: clean, simple, whitespace, subtle, elegant
Glassmorphism
- Colors: Translucent layers, blur effects, gradient backgrounds
- Effects: backdrop-blur, bg-white/10, soft shadows
- Best For: Modern dashboards, music apps, portfolios
- Keywords: glass, blur, translucent, frosted, layered
Neumorphism
- Colors: Soft pastels, same-hue shadows (dark/light)
- Effects: Inset shadows, extruded elements, soft depth
- Best For: Control panels, calculators, music players
- Keywords: soft, embossed, extruded, tactile, 3D-soft
Dark Mode
- Colors: Dark backgrounds (#0F172A), light text, accent colors
- Effects: Subtle borders, glows on focus, reduced eye strain
- Best For: Developer tools, media apps, gaming
- Keywords: dark, night, low-light, contrast, modern
Bento Grid
- Colors: Card-based with distinct backgrounds per section
- Effects: Grid layouts, varying card sizes, clear hierarchy
- Best For: Feature showcases, portfolios, dashboards
- Keywords: grid, cards, modular, organized, showcase
Aurora / Gradient Mesh
- Colors: Multi-color gradients, mesh blending, vibrant
- Effects: Animated gradients, color transitions, depth
- Best For: AI products, creative tools, landing pages
- Keywords: aurora, gradient, mesh, colorful, flowing
Brutalism
- Colors: High contrast, raw colors, bold primaries
- Effects: Heavy borders, raw typography, intentionally rough
- Best For: Creative agencies, art portfolios, bold brands
- Keywords: raw, bold, stark, unpolished, striking
Landing Page Patterns
Hero-Centric (Conversion Focus)
Sections: Hero > Social Proof > Features > CTA
- Primary CTA above fold
- Trust badges near CTA
- Single focused message
Feature-Forward (Product Demo)
Sections: Hero > Feature Grid > How It Works > Pricing > CTA
- Visual product demos
- Benefits over features
- Comparison tables for pricing
Story-Driven (Brand Building)
Sections: Hero > Problem > Solution > Journey > Team > CTA
- Emotional connection first
- Customer success stories
- Brand narrative flow
Social Proof Heavy (Trust Building)
Sections: Hero > Logos > Testimonials > Case Studies > CTA
- Client logos prominent
- Video testimonials
- Stats and numbers
Chart Type Selection
| Data Type |
Best Chart |
When to Use |
| Trend Over Time |
Line Chart |
Time-series, growth, progress |
| Compare Categories |
Bar Chart |
Rankings, comparisons |
| Part-to-Whole |
Donut Chart |
Percentages, proportions (≤5 items) |
| Correlation |
Scatter Plot |
Relationships, patterns |
| Geographic |
Choropleth Map |
Regional data, locations |
| Funnel/Flow |
Funnel Chart |
Conversion, process stages |
| Performance |
Gauge/Bullet |
KPIs, targets |
| Hierarchical |
Treemap |
Nested categories, proportions |
Chart Color Guidance:
- Primary data: #2563EB (blue-600)
- Success/Growth: #22C55E (green-500)
- Warning/Alert: #F59E0B (amber-500)
- Error/Decline: #EF4444 (red-500)
- Neutral: #94A3B8 (slate-400)
For detailed chart data (25 chart types with library recommendations, accessibility notes, and interactive levels), see data/design-data.csv.
Accessibility Requirements (CRITICAL)
Color Contrast
- Normal text: 4.5:1 minimum ratio
- Large text (18px+): 3:1 minimum ratio
- Interactive elements: Clear focus states
Touch Targets
- Minimum size: 44x44px for touch devices
- Spacing: 8px minimum between targets
Focus States
/* Always visible focus ring */
:focus-visible {
outline: 2px solid #2563EB;
outline-offset: 2px;
}
Reduced Motion
@media (prefers-reduced-motion: reduce) {
*, *::before, *::after {
animation-duration: 0.01ms !important;
transition-duration: 0.01ms !important;
}
}
Form Labels
- Every input MUST have associated label
- Use
<label for="id"> or aria-label
- Error messages near the problem field
Common UX Anti-Patterns (AVOID)
Icons
- NO: Using emojis as UI icons
- YES: Use SVG icons (Heroicons, Lucide, Simple Icons)
Hover States
- NO: Scale transforms that shift layout
- YES: Color/opacity transitions only
Cursors
- NO: Default cursor on clickable elements
- YES:
cursor-pointer on all interactive elements
Light Mode Glass
- NO:
bg-white/10 (too transparent, invisible)
- YES:
bg-white/80 or higher opacity
Z-Index
- NO: Random z-index values (999, 9999)
- YES: Defined scale: 10 (default), 20 (dropdown), 30 (modal), 50 (toast)
Animations
- NO: Slow animations (>500ms) or layout-shifting
- YES: 150-300ms duration, transform/opacity only
Stack-Specific Guidelines
HTML + Tailwind CSS
- Use utility classes, avoid custom CSS
- Responsive:
sm:, md:, lg:, xl: breakpoints
- Dark mode:
dark: variant
- Always include
cursor-pointer on buttons/links
React
- Use
memo() for expensive components
- Prefer
useMemo/useCallback for stable references
- Avoid inline functions in render
- Use Suspense for code splitting
Next.js
- Use
next/image for automatic optimization
- Implement dynamic imports for heavy components
- Use
next/font for optimized font loading
- Leverage Server Components where possible
Vue 3
- Use Composition API with
<script setup>
- Pinia for state management
defineProps with TypeScript
- Lazy load routes with dynamic imports
Flutter
- Use
const constructors for static widgets
ListView.builder for long lists
- Dispose controllers in
dispose()
- Use
Theme.of(context) for consistent theming
SwiftUI
- Use
@State for local state, @StateObject for reference types
- Prefer
.task over .onAppear for async
- Use
LazyVStack for long lists
- Support Dynamic Type for accessibility
For comprehensive stack-specific guidelines (99 rules across Flutter, SwiftUI, and more), see data/stack-guidelines.csv.
Response Style
When designing interfaces:
- Present the design system first with all recommendations
- Show color swatches with hex values and usage
- Include Google Fonts import code ready to use
- Provide code examples following stack best practices
- Explain design decisions with reasoning
Pre-Delivery Checklist
Visual Quality
Interaction
Light/Dark Mode
Layout
Accessibility
Pre-Implementation
1---2name: ui-ux-pro-max3description: UI/UX design intelligence expert for web and mobile applications. Use when designing interfaces, selecting color palettes, typography, visual styles, building landing pages, dashboards, or reviewing code for UX issues. Covers 50+ design styles, 97 color palettes, 57 font pairings, 99 UX guidelines, 25 chart types across 9 tech stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui).4---56# UI/UX Pro Max - Design Intelligence Expert78Comprehensive UI/UX design guide for web and mobile applications. Provides intelligent design recommendations based on product type, industry, and user requirements. Reference these guidelines when designing new UI, choosing colors and typography, reviewing code for UX issues, or implementing features.910---1112## Workflow1314### Step 1: Analyze User Requirements1516Extract from user request:17- **Product type**: SaaS, e-commerce, portfolio, dashboard, landing page, etc.18- **Style keywords**: minimal, playful, professional, elegant, dark mode, etc.19- **Industry**: healthcare, fintech, gaming, education, beauty, etc.20- **Tech stack**: React, Vue, Next.js, Svelte, Flutter, or html-tailwind (default)2122### Step 2: Generate Design System2324Consult the reference data below (and CSV files in `data/`) for:25- Recommended patterns and section layouts26- Primary visual style with effects27- Color palette (primary, secondary, CTA, background, text)28- Typography pairing (heading + body fonts with Google Fonts URL)29- Key effects and anti-patterns to avoid3031### Step 3: Implementation Guidelines3233Apply stack-specific best practices from the reference data:34- HTML/Tailwind utilities, responsive breakpoints35- React hooks, state management, performance patterns36- Vue Composition API, Pinia state37- Flutter widgets, themes, navigation38- Accessibility requirements (WCAG compliance)3940### Step 4: Pre-Delivery Verification4142Run through all checklists (visual quality, interaction, light/dark mode, layout, accessibility) before delivering any UI code.4344---4546## Priority Rules4748| Priority | Category | Impact |49|----------|----------|--------|50| 1 | Accessibility | CRITICAL - Color contrast 4.5:1, focus states, aria-labels |51| 2 | Touch & Interaction | CRITICAL - 44x44px touch targets, cursor-pointer |52| 3 | Performance | HIGH - Image optimization, lazy loading |53| 4 | Layout & Responsive | HIGH - Mobile-first, viewport meta |54| 5 | Typography & Color | MEDIUM - Line height 1.5-1.75, readable fonts |55| 6 | Animation | MEDIUM - 150-300ms duration, transform-only |56| 7 | Style Selection | MEDIUM - Match style to product type |5758---5960## Quick Style Selector by Product Type6162| Product Type | Primary Style | Secondary Styles | Color Mood |63|--------------|---------------|------------------|------------|64| SaaS (General) | Minimalism | Flat Design, Glassmorphism | Trust blue + accent contrast |65| E-commerce | Neo-Brutalism | Bento Grid, Dark Mode | Brand primary + success green |66| E-commerce Luxury | Luxury Minimal | Dark Mode, Elegant | Premium black + gold accents |67| Healthcare | Soft Minimalism | Flat Design, Organic | Calm blue + health green |68| Fintech/Crypto | Cyberpunk | Dark Mode, Glassmorphism | Dark tech + vibrant accents |69| Gaming | Neon Glow | Cyberpunk, Dark Mode | Vibrant + neon + immersive |70| Portfolio/Creative | Editorial | Brutalism, Asymmetric | Brand primary + artistic |71| Dashboard | Corporate Tech | Flat Design, Data-Dense | Cool→Hot gradients + neutral |72| AI/Chatbot | Aurora Gradients | Glassmorphism, Dark Mode | Neutral + AI Purple (#6366F1) |73| Beauty/Spa/Wellness | Organic Shapes | Soft Minimalism, Elegant | Soft pastels + natural tones |7475---7677## Color Palettes by Industry7879### SaaS / Business80| Role | Hex | Tailwind |81|------|-----|----------|82| Primary | #2563EB | blue-600 |83| Secondary | #3B82F6 | blue-500 |84| CTA | #F97316 | orange-500 |85| Background | #F8FAFC | slate-50 |86| Text | #1E293B | slate-800 |87| Border | #E2E8F0 | slate-200 |8889### E-commerce Luxury90| Role | Hex | Tailwind |91|------|-----|----------|92| Primary | #1C1917 | stone-900 |93| Secondary | #44403C | stone-700 |94| CTA | #CA8A04 | yellow-600 |95| Background | #FAFAF9 | stone-50 |96| Text | #0C0A09 | stone-950 |97| Border | #D6D3D1 | stone-300 |9899### Healthcare100| Role | Hex | Tailwind |101|------|-----|----------|102| Primary | #0891B2 | cyan-600 |103| Secondary | #22D3EE | cyan-400 |104| CTA | #059669 | emerald-600 |105| Background | #ECFEFF | cyan-50 |106| Text | #164E63 | cyan-900 |107| Border | #A5F3FC | cyan-200 |108109### Fintech / Crypto110| Role | Hex | Tailwind |111|------|-----|----------|112| Primary | #F59E0B | amber-500 |113| Secondary | #FBBF24 | amber-400 |114| CTA | #8B5CF6 | violet-500 |115| Background | #0F172A | slate-900 |116| Text | #F8FAFC | slate-50 |117| Border | #334155 | slate-700 |118119### Gaming120| Role | Hex | Tailwind |121|------|-----|----------|122| Primary | #7C3AED | violet-600 |123| Secondary | #A78BFA | violet-400 |124| CTA | #F43F5E | rose-500 |125| Background | #0F0F23 | custom-dark |126| Text | #E2E8F0 | slate-200 |127| Border | #4C1D95 | violet-900 |128129### AI / Chatbot Platform130| Role | Hex | Tailwind |131|------|-----|----------|132| Primary | #7C3AED | violet-600 |133| Secondary | #A78BFA | violet-400 |134| CTA | #06B6D4 | cyan-500 |135| Background | #FAF5FF | violet-50 |136| Text | #1E1B4B | indigo-950 |137| Border | #DDD6FE | violet-200 |138139### Beauty / Spa / Wellness140| Role | Hex | Tailwind |141|------|-----|----------|142| Primary | #DB2777 | pink-600 |143| Secondary | #F472B6 | pink-400 |144| CTA | #059669 | emerald-600 |145| Background | #FDF2F8 | pink-50 |146| Text | #831843 | pink-900 |147| Border | #FBCFE8 | pink-200 |148149---150151## Typography Pairings152153### Professional / Corporate154**Heading:** Inter | **Body:** Inter155```css156@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');157```158*Best for: SaaS, dashboards, business apps*159160### Elegant / Luxury161**Heading:** Playfair Display | **Body:** Lato162```css163@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:wght@500;600;700&family=Lato:wght@400;700&display=swap');164```165*Best for: Luxury brands, editorial, high-end e-commerce*166167### Modern / Tech168**Heading:** Space Grotesk | **Body:** DM Sans169```css170@import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@500;600;700&family=DM+Sans:wght@400;500;700&display=swap');171```172*Best for: Tech startups, fintech, AI products*173174### Friendly / Playful175**Heading:** Poppins | **Body:** Open Sans176```css177@import url('https://fonts.googleapis.com/css2?family=Poppins:wght@500;600;700&family=Open+Sans:wght@400;600&display=swap');178```179*Best for: Education, consumer apps, lifestyle brands*180181### Editorial / Creative182**Heading:** Fraunces | **Body:** Source Sans 3183```css184@import url('https://fonts.googleapis.com/css2?family=Fraunces:wght@500;600;700&family=Source+Sans+3:wght@400;600&display=swap');185```186*Best for: Blogs, magazines, portfolios*187188### Healthcare / Wellness189**Heading:** Outfit | **Body:** Nunito190```css191@import url('https://fonts.googleapis.com/css2?family=Outfit:wght@500;600;700&family=Nunito:wght@400;600&display=swap');192```193*Best for: Healthcare, wellness, medical apps*194195---196197## Visual Styles Reference198199### Minimalism200- **Colors:** Monochrome + 1 accent, high whitespace201- **Effects:** Subtle shadows, clean borders, micro-interactions202- **Best For:** SaaS, productivity, professional apps203- **Keywords:** clean, simple, whitespace, subtle, elegant204205### Glassmorphism206- **Colors:** Translucent layers, blur effects, gradient backgrounds207- **Effects:** backdrop-blur, bg-white/10, soft shadows208- **Best For:** Modern dashboards, music apps, portfolios209- **Keywords:** glass, blur, translucent, frosted, layered210211### Neumorphism212- **Colors:** Soft pastels, same-hue shadows (dark/light)213- **Effects:** Inset shadows, extruded elements, soft depth214- **Best For:** Control panels, calculators, music players215- **Keywords:** soft, embossed, extruded, tactile, 3D-soft216217### Dark Mode218- **Colors:** Dark backgrounds (#0F172A), light text, accent colors219- **Effects:** Subtle borders, glows on focus, reduced eye strain220- **Best For:** Developer tools, media apps, gaming221- **Keywords:** dark, night, low-light, contrast, modern222223### Bento Grid224- **Colors:** Card-based with distinct backgrounds per section225- **Effects:** Grid layouts, varying card sizes, clear hierarchy226- **Best For:** Feature showcases, portfolios, dashboards227- **Keywords:** grid, cards, modular, organized, showcase228229### Aurora / Gradient Mesh230- **Colors:** Multi-color gradients, mesh blending, vibrant231- **Effects:** Animated gradients, color transitions, depth232- **Best For:** AI products, creative tools, landing pages233- **Keywords:** aurora, gradient, mesh, colorful, flowing234235### Brutalism236- **Colors:** High contrast, raw colors, bold primaries237- **Effects:** Heavy borders, raw typography, intentionally rough238- **Best For:** Creative agencies, art portfolios, bold brands239- **Keywords:** raw, bold, stark, unpolished, striking240241---242243## Landing Page Patterns244245### Hero-Centric (Conversion Focus)246**Sections:** Hero > Social Proof > Features > CTA247- Primary CTA above fold248- Trust badges near CTA249- Single focused message250251### Feature-Forward (Product Demo)252**Sections:** Hero > Feature Grid > How It Works > Pricing > CTA253- Visual product demos254- Benefits over features255- Comparison tables for pricing256257### Story-Driven (Brand Building)258**Sections:** Hero > Problem > Solution > Journey > Team > CTA259- Emotional connection first260- Customer success stories261- Brand narrative flow262263### Social Proof Heavy (Trust Building)264**Sections:** Hero > Logos > Testimonials > Case Studies > CTA265- Client logos prominent266- Video testimonials267- Stats and numbers268269---270271## Chart Type Selection272273| Data Type | Best Chart | When to Use |274|-----------|------------|-------------|275| Trend Over Time | Line Chart | Time-series, growth, progress |276| Compare Categories | Bar Chart | Rankings, comparisons |277| Part-to-Whole | Donut Chart | Percentages, proportions (≤5 items) |278| Correlation | Scatter Plot | Relationships, patterns |279| Geographic | Choropleth Map | Regional data, locations |280| Funnel/Flow | Funnel Chart | Conversion, process stages |281| Performance | Gauge/Bullet | KPIs, targets |282| Hierarchical | Treemap | Nested categories, proportions |283284**Chart Color Guidance:**285- Primary data: #2563EB (blue-600)286- Success/Growth: #22C55E (green-500)287- Warning/Alert: #F59E0B (amber-500)288- Error/Decline: #EF4444 (red-500)289- Neutral: #94A3B8 (slate-400)290291For detailed chart data (25 chart types with library recommendations, accessibility notes, and interactive levels), see `data/design-data.csv`.292293---294295## Accessibility Requirements (CRITICAL)296297### Color Contrast298- **Normal text:** 4.5:1 minimum ratio299- **Large text (18px+):** 3:1 minimum ratio300- **Interactive elements:** Clear focus states301302### Touch Targets303- **Minimum size:** 44x44px for touch devices304- **Spacing:** 8px minimum between targets305306### Focus States307```css308/* Always visible focus ring */309:focus-visible {310 outline: 2px solid #2563EB;311 outline-offset: 2px;312}313```314315### Reduced Motion316```css317@media (prefers-reduced-motion: reduce) {318 *, *::before, *::after {319 animation-duration: 0.01ms !important;320 transition-duration: 0.01ms !important;321 }322}323```324325### Form Labels326- Every input MUST have associated label327- Use `<label for="id">` or aria-label328- Error messages near the problem field329330---331332## Common UX Anti-Patterns (AVOID)333334### Icons335- NO: Using emojis as UI icons336- YES: Use SVG icons (Heroicons, Lucide, Simple Icons)337338### Hover States339- NO: Scale transforms that shift layout340- YES: Color/opacity transitions only341342### Cursors343- NO: Default cursor on clickable elements344- YES: `cursor-pointer` on all interactive elements345346### Light Mode Glass347- NO: `bg-white/10` (too transparent, invisible)348- YES: `bg-white/80` or higher opacity349350### Z-Index351- NO: Random z-index values (999, 9999)352- YES: Defined scale: 10 (default), 20 (dropdown), 30 (modal), 50 (toast)353354### Animations355- NO: Slow animations (>500ms) or layout-shifting356- YES: 150-300ms duration, transform/opacity only357358---359360## Stack-Specific Guidelines361362### HTML + Tailwind CSS363- Use utility classes, avoid custom CSS364- Responsive: `sm:`, `md:`, `lg:`, `xl:` breakpoints365- Dark mode: `dark:` variant366- Always include `cursor-pointer` on buttons/links367368### React369- Use `memo()` for expensive components370- Prefer `useMemo`/`useCallback` for stable references371- Avoid inline functions in render372- Use Suspense for code splitting373374### Next.js375- Use `next/image` for automatic optimization376- Implement dynamic imports for heavy components377- Use `next/font` for optimized font loading378- Leverage Server Components where possible379380### Vue 3381- Use Composition API with `<script setup>`382- Pinia for state management383- `defineProps` with TypeScript384- Lazy load routes with dynamic imports385386### Flutter387- Use `const` constructors for static widgets388- `ListView.builder` for long lists389- Dispose controllers in `dispose()`390- Use `Theme.of(context)` for consistent theming391392### SwiftUI393- Use `@State` for local state, `@StateObject` for reference types394- Prefer `.task` over `.onAppear` for async395- Use `LazyVStack` for long lists396- Support Dynamic Type for accessibility397398For comprehensive stack-specific guidelines (99 rules across Flutter, SwiftUI, and more), see `data/stack-guidelines.csv`.399400---401402## Response Style403404When designing interfaces:4051. **Present the design system** first with all recommendations4062. **Show color swatches** with hex values and usage4073. **Include Google Fonts import** code ready to use4084. **Provide code examples** following stack best practices4095. **Explain design decisions** with reasoning410411---412413## Pre-Delivery Checklist414415### Visual Quality416- [ ] No emojis as icons (use SVG: Heroicons, Lucide, Simple Icons)417- [ ] All icons from consistent icon set418- [ ] Brand logos verified from official sources419- [ ] Hover states don't cause layout shift420421### Interaction422- [ ] All clickable elements have `cursor-pointer`423- [ ] Hover states provide clear visual feedback424- [ ] Transitions are smooth (150-300ms)425- [ ] Focus states visible for keyboard navigation426427### Light/Dark Mode428- [ ] Light mode text has sufficient contrast (4.5:1 minimum)429- [ ] Glass/transparent elements visible in light mode430- [ ] Borders visible in both modes431432### Layout433- [ ] Floating elements have proper spacing from edges434- [ ] No content hidden behind fixed navbars435- [ ] Responsive at 375px, 768px, 1024px, 1440px436- [ ] No horizontal scroll on mobile437438### Accessibility439- [ ] All images have alt text440- [ ] Form inputs have labels441- [ ] Color is not the only indicator442- [ ] `prefers-reduced-motion` respected443444### Pre-Implementation445- [ ] Product type identified446- [ ] Visual style selected447- [ ] Color palette defined448- [ ] Typography pairing chosen449- [ ] Landing page pattern selected450- [ ] Accessibility requirements noted451- [ ] Tech stack guidelines reviewed