Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

fix(theme-neutral): darken light secondary text to meet WCAG AA contrast (#4557)

Humberto Virtudesc75407e015f5
diff --git a/.changeset/neutral-secondary-text-contrast.md b/.changeset/neutral-secondary-text-contrast.md
new file mode 100644
index 0000000000..ca67e067da
--- /dev/null
+++ b/.changeset/neutral-secondary-text-contrast.md
@@ -0,0 +1,6 @@
+---
+'@astryxdesign/theme-neutral': patch
+---
+
+[fix] neutral theme: darken light-mode `--color-text-secondary` from neutral-500 (#737373) to neutral-600 (#525252). 500 only reached 4.19:1 on the T95 body background (#f1f1f1), just under WCAG AA 1.4.3 (4.5:1); 600 clears it. Dark mode is unchanged.
+@humbertovirtudes
diff --git a/packages/themes/neutral/src/neutralTheme.ts b/packages/themes/neutral/src/neutralTheme.ts
index e658ee895f..ace0fd91ec 100644
--- a/packages/themes/neutral/src/neutralTheme.ts
+++ b/packages/themes/neutral/src/neutralTheme.ts
@@ -144,7 +144,10 @@ export const neutralTheme = defineTheme({
// Text
'--color-text-primary': ['#171717', '#fafafa'],
- '--color-text-secondary': ['#737373', '#a3a3a3'],
+ // Light secondary is neutral-600 (#525252), not 500 (#737373): 500 only
+ // reaches 4.19:1 on the T95 body (#f1f1f1), just under WCAG AA 4.5:1.
+ // 600 clears it (6.9:1 on body, 7.8:1 on card). Dark stays neutral-400.
+ '--color-text-secondary': ['#525252', '#a3a3a3'],
'--color-text-disabled': ['#a3a3a3', '#525252'],
'--color-text-accent': ['#262626', '#ebebeb'],
'--color-on-dark': '#ffffff',