Skip to content

fix(website): meet AA contrast, stop clipping the timeline, let the figures pause - #603

Merged
bmscomp merged 1 commit into
mainfrom
fix/website-p1
Nov 5, 2026
Merged

bmscomp merged 1 commit into
mainfrom
fix/website-p1

Conversation

@bmscomp

@bmscomp bmscomp commented Nov 5, 2026

Copy link
Copy Markdown
Owner

Why

An audit of katesplatform.io scored it 12/20. These are its four P1 findings. The worst: "Get started", the nav's primary button, was nearly unreadable at 2.0:1, because .nav-links a overrode the button's white text.

What changed

  • Button contrast: "Get started" is now 6.15:1. The button's colors live in their own rule and the end-of-file Paper patch for them is gone.
  • Secondary text: code blocks get --code-muted, --code-ok and --code-prompt, because one --ok could not pass on both the light page and the dark blocks. --ok and --no darken for the table. The skip link is fixed too.
  • Clipped timeline: on phones "5 Graded" was cut off with no way to scroll. The steps now wrap to 3 + 2.
  • Pause (WCAG 2.2.2): each looping figure gets a Pause / Play button. The timeline still works while paused, and the button stays hidden under reduced motion.

Checks

  • impeccable detect: no low-contrast findings at 1280px or 390px; total findings 45 → 31 and 47 → 36.
  • html-validate@9, as CI runs it, passes.
  • Browser at 375px and 1280px: all five steps fit, no sideways scroll, both figures stop and resume.

Not tested

Emulated reduced motion, a real Tab-key walk, a real phone, and the contrast of the diagram's other two color presets.

Deliberately not done

The audit's P2s (security headers, focusable scrollers, menu keys, touch hints, fonts, image dimensions) follow in a separate PR.

Green is slightly darker on the light page, which is worth a look in the preview.

…igures pause

"Get started" rendered dark text on blue (2.0:1) because .nav-links a beat
.btn-primary. The Paper theme was patched on at the end of styles.css, so the
button's colors move to their own rule and the patch goes.

One --ok could not pass on both the light page and the dark code blocks, so
code gets its own tokens. The table's Yes and No, terminal titles, comments
and prompts and the skip link now meet 4.5:1.

On phones five timeline buttons needed 357px of 309px and the figure hid the
fifth. They wrap to 3 + 2. Both looping figures gain a pause button (WCAG
2.2.2), which stays hidden when motion is reduced because nothing loops then.
@bmscomp
bmscomp merged commit cbbe876 into main Nov 5, 2026
60 checks passed
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