Visual System Review
Check that visual choices serve the user and match (or extend, deliberately) the existing design language.
What to evaluate
- Hierarchy. Does the eye go to the right place first? Does importance match visual weight?
- Consistency. Are buttons, inputs, spacing, and typography drawn from the existing system, or invented locally?
- Information density. Is the screen too quiet or too noisy for its purpose?
- Copy fit. Does the text fit the container at the longest realistic length? At the shortest?
- Contrast and readability. Does it work for users with vision impairments and on small screens?
- Affordances. Are interactive elements obviously interactive? Are read-only elements clearly not?
Token discipline
Visual choices should resolve to tokens, not magic numbers:
- Typography: a defined scale (xs/sm/base/lg/xl…), 2–3 weights max, line-height 1.1–1.3 for headings, 1.5–1.7 for body.
- Spacing: a defined scale (4px or 8px base). Component padding 16–24px, section gaps 32–64px, icon-text gap 8px.
- Color: semantic roles (primary, success, warning, error, neutral 50–900). Contrast ≥ 4.5:1 for body, ≥ 3:1 for large text and UI components.
- Icons: a defined size scale (12/16/20/24/32). One stroke-weight family.
When a token is missing for something that should have one, flag it as a design-system gap, not just a local issue.
Subtraction default
For every element, ask: does this earn its pixels? If not, cut it. Most screens improve when something is removed.
Output
- Specific issues with the screen as it is.
- Suggested changes, ranked by user impact.
- Anything that violates the existing design system (new button styles, ad-hoc spacing, custom colors, off-scale type).
- Tokens or patterns missing from the design system that this work surfaces.
1---2name: visual-system-review3description: Use to evaluate visual consistency, hierarchy, and design-system adherence — typography, color, spacing, density, tokens.4---56# Visual System Review78Check that visual choices serve the user and match (or extend, deliberately) the existing design language.910## What to evaluate11121. **Hierarchy.** Does the eye go to the right place first? Does importance match visual weight?132. **Consistency.** Are buttons, inputs, spacing, and typography drawn from the existing system, or invented locally?143. **Information density.** Is the screen too quiet or too noisy for its purpose?154. **Copy fit.** Does the text fit the container at the longest realistic length? At the shortest?165. **Contrast and readability.** Does it work for users with vision impairments and on small screens?176. **Affordances.** Are interactive elements obviously interactive? Are read-only elements clearly not?1819## Token discipline2021Visual choices should resolve to tokens, not magic numbers:2223- **Typography:** a defined scale (xs/sm/base/lg/xl…), 2–3 weights max, line-height 1.1–1.3 for headings, 1.5–1.7 for body.24- **Spacing:** a defined scale (4px or 8px base). Component padding 16–24px, section gaps 32–64px, icon-text gap 8px.25- **Color:** semantic roles (primary, success, warning, error, neutral 50–900). Contrast ≥ 4.5:1 for body, ≥ 3:1 for large text and UI components.26- **Icons:** a defined size scale (12/16/20/24/32). One stroke-weight family.2728When a token is missing for something that should have one, flag it as a design-system gap, not just a local issue.2930## Subtraction default3132For every element, ask: does this earn its pixels? If not, cut it. Most screens improve when something is removed.3334## Output3536- Specific issues with the screen as it is.37- Suggested changes, ranked by user impact.38- Anything that violates the existing design system (new button styles, ad-hoc spacing, custom colors, off-scale type).39- Tokens or patterns missing from the design system that this work surfaces.