Skip to content

fix: restore docs footer contrast in light mode#63

Merged
abrichr merged 1 commit into
mainfrom
agent/docs-footer-contrast
Jul 25, 2026
Merged

fix: restore docs footer contrast in light mode#63
abrichr merged 1 commit into
mainfrom
agent/docs-footer-contrast

Conversation

@abrichr

@abrichr abrichr commented Jul 25, 2026

Copy link
Copy Markdown
Member

What changed

  • explicitly color Material's inner copyright wrapper in the light palette
  • explicitly color footer links and social icons, including hover and focus states
  • keep the existing dark palette unchanged

Why

The live footer container had the intended warm light background and dark
foreground, but MkDocs Material applies semi-transparent white directly to
.md-copyright__highlight and footer links. Those child declarations overrode
the inherited brand color, producing approximately 1.01:1 white-on-white
contrast in light/system mode.

The fixed light palette computes to 7.92:1 for copyright text and 5.98:1 for
links/icons on the footer background, exceeding WCAG AA for normal text. Dark
visible text remains 9.39:1.

Validation

  • uv run pytest tests/ -q — 76 passed
  • uv run python scripts/validate_docs.py — passed
  • uv run mkdocs build --strict — passed
  • headless Chromium screenshots and computed-style checks at 1440×900 and
    390×844 for light, dark, and no-preference/system-default palettes
  • git diff --check

@abrichr
abrichr marked this pull request as ready for review July 25, 2026 16:56
@abrichr
abrichr merged commit b75e582 into main Jul 25, 2026
5 checks passed
@abrichr
abrichr deleted the agent/docs-footer-contrast branch July 25, 2026 16:56
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.

1 participant