CSS Primer For the AI Era

A vocabulary for shaping interfaces with AI

User Tools

Site Tools


vocabulary:css_visual_vocabulary:hue_contrast

Hue Contrast

— the difference between colors
based on their position on the color wheel

Hue contrast is the contrast of color family
— blue vs. orange, red vs. green, yellow vs. purple.
It is the most expressive form of contrast,
shaping personality, energy, and emotional temperature.

Hue contrast does not guarantee readability.
It creates feeling, not clarity
.


What hue contrast does

  • Adds expressiveness — complementary hues feel energetic
  • hapes tone — warm vs. cool shifts emotional temperature
  • Creates visual interest — contrasting hues draw the eye
  • Supports hierarchy — when paired with value contrast
  • Defines identity — brand palettes rely heavily on hue contrast

Hue contrast is the color conversation
happening beneath the structure.


How we describe hue contrast when working with AI

These phrases give AI clear, predictable direction:

“Increase the hue contrast between these elements.”
“Use a complementary hue for emphasis.”
“Shift this to a cooler hue for a calmer tone.”
“Keep the hue contrast subtle to maintain restraint.”
“Use hue contrast without increasing value contrast.”

This separates color family from lightness
— a crucial distinction
.


Types of hue contrast

  • Complementary contrast — opposite hues (blue–orange, red–green)
  • Analogous contrast — neighboring hues (blue–teal–green)
  • Triadic contrast — evenly spaced hues (red–yellow–blue)
  • Warm–cool contrast — emotional temperature differences

Each type expresses a different emotional quality.


Why hue contrast is not enough for readability

Two hues can be very different but still unreadable
if their lightness values are similar.

For example:

  • bright red text on bright green
  • blue text on purple
  • yellow text on white

Hue contrast creates personality.
Value contrast creates clarity
.

This is why 'hue contrast' must be paired with
'lightness contrast' for text and UI elements.



Tony de Araujo —New York | Lisbon


vocabulary/css_visual_vocabulary/hue_contrast.txt · Last modified: by editor