Skip to content

fix: light mode docs link colors unreadable on white background - #10457

Merged
teknium1 merged 1 commit into
mainfrom
hermes/hermes-3095fab9
Apr 15, 2026
Merged

fix: light mode docs link colors unreadable on white background#10457
teknium1 merged 1 commit into
mainfrom
hermes/hermes-3095fab9

Conversation

@teknium1

Copy link
Copy Markdown
Contributor

Summary

Community report from @AbrahamMat7632: gold link color (#FFD700) is impossible to read in light mode.

Root cause: :root (light mode) and [data-theme='dark'] shared identical gold palette. Gold on white has 1.4:1 contrast ratio — well below WCAG AA minimum of 4.5:1.

Changes

Single file: website/src/css/custom.css (35 insertions, 9 deletions)

  • Light mode primary palette → dark amber tones (#8B6508 primary) with 5.3:1 contrast ratio
  • Light mode link colors → #7A5800 (6.5:1 ratio) / #5A4100 hover (9.6:1 ratio)
  • Light mode sidebar active → amber accent border
  • Light mode table styling → amber-tinted headers/borders
  • Footer hover → split by theme (gold stays for dark, amber for light)

Dark mode is completely unchanged.

Contrast ratios (verified)

Element Color Contrast on white WCAG AA
Primary (old) #FFD700 1.4:1 ❌ FAIL
Primary (new) #8B6508 5.3:1 ✅ PASS
Links #7A5800 6.5:1 ✅ PASS
Link hover #5A4100 9.6:1 ✅ PASS

Test plan

Toggle to light mode on any docs page with links/tables — links should now be a readable dark amber instead of invisible gold.

Gold #FFD700 has 1.4:1 contrast ratio on white — barely visible.
Replace with dark amber palette (#8B6508 primary, #7A5800 links)
that passes WCAG AA (5.3:1 and 6.5:1 respectively).

Changes:
- :root primary palette → dark amber tones for light mode
- Explicit light mode link colors (#7A5800 / #5A4100 hover)
- Light mode sidebar active state with amber accent
- Light mode table header/border styling
- Footer hover color split by theme (gold for dark, amber for light)

Dark mode is completely unchanged.

Reported by @AbrahamMat7632
@RuckVibeCodes

Copy link
Copy Markdown

[gus-first-pass] Reviewed PR #10457: fix: light mode docs link colors unreadable on white background. No critical issues found.

@RuckVibeCodes RuckVibeCodes left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall looks good, no issues found. However, I recommend confirming the color contrast ratios with accessibility guidelines.

@teknium1
teknium1 merged commit 2dc5f9d into main Apr 15, 2026
3 of 5 checks passed
@teknium1
teknium1 deleted the hermes/hermes-3095fab9 branch April 15, 2026 18:17
kagura-agent pushed a commit to kagura-agent/hermes-agent that referenced this pull request Apr 16, 2026
…ousResearch#10457)

Gold #FFD700 has 1.4:1 contrast ratio on white — barely visible.
Replace with dark amber palette (#8B6508 primary, #7A5800 links)
that passes WCAG AA (5.3:1 and 6.5:1 respectively).

Changes:
- :root primary palette → dark amber tones for light mode
- Explicit light mode link colors (#7A5800 / #5A4100 hover)
- Light mode sidebar active state with amber accent
- Light mode table header/border styling
- Footer hover color split by theme (gold for dark, amber for light)

Dark mode is completely unchanged.

Reported by @AbrahamMat7632
aj-nt pushed a commit to aj-nt/hermes-agent that referenced this pull request May 1, 2026
…ousResearch#10457)

Gold #FFD700 has 1.4:1 contrast ratio on white — barely visible.
Replace with dark amber palette (#8B6508 primary, #7A5800 links)
that passes WCAG AA (5.3:1 and 6.5:1 respectively).

Changes:
- :root primary palette → dark amber tones for light mode
- Explicit light mode link colors (#7A5800 / #5A4100 hover)
- Light mode sidebar active state with amber accent
- Light mode table header/border styling
- Footer hover color split by theme (gold for dark, amber for light)

Dark mode is completely unchanged.

Reported by @AbrahamMat7632
02356abc pushed a commit to 02356abc/hermes-agent that referenced this pull request May 14, 2026
…ousResearch#10457)

Gold #FFD700 has 1.4:1 contrast ratio on white — barely visible.
Replace with dark amber palette (#8B6508 primary, #7A5800 links)
that passes WCAG AA (5.3:1 and 6.5:1 respectively).

Changes:
- :root primary palette → dark amber tones for light mode
- Explicit light mode link colors (#7A5800 / #5A4100 hover)
- Light mode sidebar active state with amber accent
- Light mode table header/border styling
- Footer hover color split by theme (gold for dark, amber for light)

Dark mode is completely unchanged.

Reported by @AbrahamMat7632
gweeteve pushed a commit to gweeteve/hermes-agent that referenced this pull request Jun 2, 2026
…ousResearch#10457)

Gold #FFD700 has 1.4:1 contrast ratio on white — barely visible.
Replace with dark amber palette (#8B6508 primary, #7A5800 links)
that passes WCAG AA (5.3:1 and 6.5:1 respectively).

Changes:
- :root primary palette → dark amber tones for light mode
- Explicit light mode link colors (#7A5800 / #5A4100 hover)
- Light mode sidebar active state with amber accent
- Light mode table header/border styling
- Footer hover color split by theme (gold for dark, amber for light)

Dark mode is completely unchanged.

Reported by @AbrahamMat7632
waefrebeorn pushed a commit to waefrebeorn/slermes that referenced this pull request Jul 2, 2026
…ousResearch#10457)

Gold #FFD700 has 1.4:1 contrast ratio on white — barely visible.
Replace with dark amber palette (#8B6508 primary, #7A5800 links)
that passes WCAG AA (5.3:1 and 6.5:1 respectively).

Changes:
- :root primary palette → dark amber tones for light mode
- Explicit light mode link colors (#7A5800 / #5A4100 hover)
- Light mode sidebar active state with amber accent
- Light mode table header/border styling
- Footer hover color split by theme (gold for dark, amber for light)

Dark mode is completely unchanged.

Reported by @AbrahamMat7632
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants