FAIL
Incorrect: teal text on white -- 2.9 : 1 contrast (fails WCAG AA)
Save up to 30% on your energy bill with real-time monitoring.
PASS
Corrected: neutral.900 text on white -- readable, accessible
Save up to 30% on your energy bill with real-time monitoring.
Documentation
Bad: Brand Teal as Text on White Background
Category
color
Classification
bad
What to Notice
- Brand teal
#0fc8c3used directly as text color on white (#ffffff) background - Contrast ratio is approximately 2.9:1 – fails WCAG AA for normal text (requires 4.5:1)
- Also fails WCAG AA for large text (requires 3:1)
- The text appears washed out and difficult to read, especially at body sizes
Tokens Referenced
color.brand.verdigris–#0fc8c3, not safe for text on light backgroundscolor.brand_teal.never_as_text_on_white– explicit rule prohibiting this usage
Code Example (What NOT to Do)
/* DO NOT do this */
.highlight-text {
color: var(--color-brand-verdigris); /* #0fc8c3 */
background: #ffffff;
}
<p class="highlight-text">
Save up to 30% on your energy bill with real-time monitoring.
</p>
Fix
Use color.brand.verdigris only on dark backgrounds (neutral.950) where it passes WCAG AA. For teal-tinted text on light backgrounds, use the darkened variant (color.legacy.www-primary-light) which achieves ~4.9:1 contrast. Alternatively, use the brand teal for decorative, non-text elements like backgrounds, borders, or icons where contrast requirements do not apply.
/* Correct: darkened teal for text on light backgrounds */
.highlight-text {
color: var(--color-text-teal-safe);
background: #ffffff;
}
/* Correct: brand teal for text on dark backgrounds */
.highlight-text-dark {
color: var(--color-brand-verdigris);
background: var(--color-neutral-950);
}