Files
Arnaud Héritier 60d3826462 fix(docs): fix dark-mode contrast violations surfaced by the both-theme gate
Running the new deterministic dark scan (previous commit) against the
full site found 2 real, previously-undetected dark-mode AA failures
(both predate this PR stack, caught only because nothing had scanned
dark mode as its own deterministic target before):

- .preview-banner a used --accent (blue-400, 4.08:1 on --bg-card in
  dark) instead of --accent-on-card (blue-300, 5.89:1) -- the same
  token already used for elevator/usecase/glossary text-on-card, just
  missed here.
- .content a's prose-link color (--accent-hover) had higher CSS
  specificity than .btn-primary/.btn-secondary's own color, so it
  silently leaked onto any button rendered as a link inside .content
  (the homepage 'Quick Start' button, 'View on GitHub'). Invisible in
  light mode only because --accent and --blue-500 happen to share a
  hex there; in dark it dropped the Quick Start button to 2.55:1.
  Fixed by excluding .btn links from the prose-link rule
  (.content a:not(.btn)) instead of fighting specificity per button.
- 404.md's 'Back to Docs' button hardcoded color:white against
  background:var(--accent) inline; --accent's dark value (blue-400)
  only reads 3.94:1 against white. Swapped to --accent-strong (a
  fixed blue-500, identical in both themes), which reads 5.00:1 for
  white text in both.

Verified via a local Hugo build + pa11y-ci@3.1.0 (system Chrome) run
across all 4 pages x 2 themes: 8/8 URLs, 0 errors.
2026-07-16 16:22:12 +02:00

272 B

title, url
title url
Page Not Found /404.html

The page you're looking for doesn't exist or has been moved.

← Back to Docs