ui-ux-pro-max

Comprehensive design guide for web and mobile applications. Contains 67 styles, 96 color palettes, 57 font pairings, 99 UX guidelines, and 25 chart types across 13 technology stacks. Searchable database with priority-based recommendations.

When to Apply

Reference these guidelines when:

Designing new UI components or pages
Choosing color palettes and typography
Reviewing code for UX issues
Building landing pages or dashboards
Implementing accessibility requirements

Rule Categories by Priority

| Priority | Category | Impact | Domain | |----------|----------|--------|--------| | 1 | Accessibility | CRITICAL | ux | | 2 | Touch & Interaction | CRITICAL | ux | | 3 | Performance | HIGH | ux | | 4 | Layout & Responsive | HIGH | ux | | 5 | Typography & Color | MEDIUM | typography, color | | 6 | Animation | MEDIUM | ux | | 7 | Style Selection | MEDIUM | style, product | | 8 | Charts & Data | LOW | chart |

Quick Reference

1. Accessibility (CRITICAL)

color-contrast - Minimum 4.5:1 ratio for normal text
focus-states - Visible focus rings on interactive elements
alt-text - Descriptive alt text for meaningful images
aria-labels - aria-label for icon-only buttons
keyboard-nav - Tab order matches visual order
form-labels - Use label with for attribute

2. Touch & Interaction (CRITICAL)

touch-target-size - Minimum 44x44px touch targets
hover-vs-tap - Use click/tap for primary interactions
loading-buttons - Disable button during async operations
error-feedback - Clear error messages near problem
cursor-pointer - Add cursor-pointer to clickable elements

3. Performance (HIGH)

image-optimization - Use WebP, srcset, lazy loading
reduced-motion - Check prefers-reduced-motion
content-jumping - Reserve space for async content

4. Layout & Responsive (HIGH)

viewport-meta - width=device-width initial-scale=1
readable-font-size - Minimum 16px body text on mobile
horizontal-scroll - Ensure content fits viewport width
z-index-management - Define z-index scale (10, 20, 30, 50)

How to Use This Skill

When user requests UI/UX work (design, build, create, implement, review, fix, improve), follow this workflow:

Step 1: Analyze User Requirements

Extract key information 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, etc.
Stack: React, Vue, Next.js, or default to html-tailwind

Step 2: Generate Design System (REQUIRED)

Always start with --design-system to get comprehensive recommendations with reasoning:

python3 /Volumes/MacOS/个人项目/skills/GitHub/TraeSkill/.trae/Skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]

This command:

Searches 5 domains in parallel (product, style, color, landing, typography)
Applies reasoning rules from ui-reasoning.csv to select best matches
Returns complete design system: pattern, style, colors, typography, effects
Includes anti-patterns to avoid

Example:

python3 /Volumes/MacOS/个人项目/skills/GitHub/TraeSkill/.trae/Skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"

Step 3: Supplement with Detailed Searches (as needed)

After getting the design system, use domain searches to get additional details:

python3 /Volumes/MacOS/个人项目/skills/GitHub/TraeSkill/.trae/Skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]

| Need | Domain | Example | |------|--------|---------| | More style options | style | --domain style "glassmorphism dark" | | Chart recommendations | chart | --domain chart "real-time dashboard" | | UX best practices | ux | --domain ux "animation accessibility" | | Alternative fonts | typography | --domain typography "elegant luxury" | | Landing structure | landing | --domain landing "hero social-proof" |

Step 4: Stack Guidelines (Default: html-tailwind)

Get implementation-specific best practices. If user doesn't specify a stack, default to html-tailwind.

python3 /Volumes/MacOS/个人项目/skills/GitHub/TraeSkill/.trae/Skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind

Available stacks: html-tailwind, react, nextjs, vue, svelte, swiftui, react-native, flutter, shadcn, jetpack-compose

Output Formats

The --design-system flag supports two output formats:

# ASCII box (default) - best for terminal display
python3 /Volumes/MacOS/个人项目/skills/GitHub/TraeSkill/.trae/Skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system

# Markdown - best for documentation
python3 /Volumes/MacOS/个人项目/skills/GitHub/TraeSkill/.trae/Skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown

Pre-Delivery Checklist

Before delivering UI code, verify these items:

Visual Quality

[ ] No emojis used as icons (use SVG instead)
[ ] All icons from consistent icon set (Heroicons/Lucide)
[ ] Brand logos are correct (verified from Simple Icons)
[ ] Hover states don't cause layout shift

Interaction

[ ] All clickable elements have cursor-pointer
[ ] Hover states provide clear visual feedback
[ ] Transitions are smooth (150-300ms)
[ ] Focus states visible for keyboard navigation

Accessibility

[ ] All images have alt text
[ ] Form inputs have labels
[ ] Color is not the only indicator
[ ] prefers-reduced-motion respected