// the find
coryhouse/a11y
Repository on accessibility
A before/after demo app for teaching web accessibility, paired with a detailed README that doubles as a reference guide. The `master` branch ships broken markup; `fixed` branch shows the corrected version. It's a teaching tool, not a library.
The before/after branch structure is a genuinely effective teaching device — seeing the broken version first makes the fixes land harder. The README audit checklist is practical and opinionated in the right ways (the disabled-buttons-suck link, aria-label as a code smell). The WCAG text contrast size thresholds note is the kind of specific detail most a11y writeups skip. Screen reader cheatsheets for NVDA, VoiceOver, and ChromeVox in one place saves real time.
The demo app itself is a single HTML file with no meaningful complexity — it can't model anything harder than form labels and heading order, so it doesn't help with the genuinely tricky cases like custom comboboxes, virtualized lists, or SPA routing. Last push was April 2024 and the repo hasn't grown since the initial examples, so it won't track newer ARIA patterns or the evolving screen reader support landscape. The README links lean heavily on Twitter/X threads as sources, which rot and disappear. No automated test suite against the 'fixed' branch, so drift between the checklist and the actual code is undetected.