2.6 KiB
2.6 KiB
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 textfocus-states- Visible focus rings on interactive elementsalt-text- Descriptive alt text for meaningful imagesaria-labels- aria-label for icon-only buttonskeyboard-nav- Tab order matches visual orderform-labels- Use label with for attribute
2. Touch & Interaction (CRITICAL)
touch-target-size- Minimum 44x44px touch targetshover-vs-tap- Use click/tap for primary interactionsloading-buttons- Disable button during async operationserror-feedback- Clear error messages near problemcursor-pointer- Add cursor-pointer to clickable elements
3. Performance (HIGH)
image-optimization- Use WebP, srcset, lazy loadingreduced-motion- Check prefers-reduced-motioncontent-jumping- Reserve space for async content
4. Layout & Responsive (HIGH)
viewport-meta- width=device-width initial-scale=1readable-font-size- Minimum 16px body text on mobilehorizontal-scroll- Ensure content fits viewport widthz-index-management- Define z-index scale (10, 20, 30, 50)
5. Typography & Color (MEDIUM)
line-height- Use 1.5-1.75 for body textline-length- Limit to 65-75 characters per linefont-pairing- Match heading/body font personalities
6. Animation (MEDIUM)
duration-timing- Use 150-300ms for micro-interactionstransform-performance- Use transform/opacity, not width/heightloading-states- Skeleton screens or spinners
7. Style Selection (MEDIUM)
style-match- Match style to product typeconsistency- Use same style across all pagesno-emoji-icons- Use SVG icons, not emojis
8. Charts & Data (LOW)
chart-type- Match chart type to data typecolor-guidance- Use accessible color palettesdata-table- Provide table alternative for accessibility
How to Use
Search specific domains using the CLI tool below.