From ee1439656b04e44e6edd42efe188e55f33b52a2b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=89mile=20R=C3=A9?= Date: Thu, 18 Jun 2026 11:38:19 +0200 Subject: [PATCH] Fix contrast guarantee in v2 color guide MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Radix documents the 11/12 APCA guarantee against a step 2 background only, not step 1. Correct the claim and the example (which used bg-sand-1), add the precise Lc 60 / Lc 90 targets and a source link, and note that step 1 is safe in practice but not part of the stated guarantee. Signed-off-by: Émile Ré --- contrib/claude/v2-colors.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/contrib/claude/v2-colors.md b/contrib/claude/v2-colors.md index b5d624a71..7f284bc16 100644 --- a/contrib/claude/v2-colors.md +++ b/contrib/claude/v2-colors.md @@ -81,7 +81,7 @@ Use **sand** for all general UI chrome: page backgrounds, card backgrounds, bord ## Contrast guarantees -Per the Radix spec, steps 11 and 12 are guaranteed to meet APCA contrast requirements on top of a step 1 or 2 background from the same scale. This means `text-sand-11` on `bg-sand-2` is always readable, and `text-sand-12` on `bg-sand-1` is always readable. +Per the [Radix spec](https://www.radix-ui.com/colors/docs/palette-composition/understanding-the-scale), steps 11 and 12 — which are designed for text — are guaranteed to reach Lc 60 and Lc 90 APCA contrast respectively on top of a **step 2** background from the same scale. So both `text-sand-11` and `text-sand-12` are readable on `bg-sand-2`. The guarantee is documented against step 2 only; step 1 is the more extreme background (lighter in light mode, darker in dark mode), so text steps stay at least as readable there in practice, but Radix does not state it as a guarantee. ## Dark mode