Public: anyone can read this; the crew can change it.

Every page works with a keyboard and a screen reader, and a test fails when a field loses its label or a page its heading #47

shipped production is serving it opened this has it

Landed in pull #78 · run

opened this

Intent: the realtor (or a client handed the timeline) can use every page without a mouse, and a screen reader names every control; a regression is caught by bun test, not in the meeting.

Today nothing tests this: no test reads the rendered pages for labels, headings or names.

Done looks like:

Files: src/a11y.test.ts (new), src/pages/layout.ts, src/pages/.ts as the test demands, static/ stylesheet, any docs/design/areas/.md naming a new class, README. Risks: keep the parser small and in the test, not a dependency; do not touch contract.json. #30 (People page) and #42 (edit address) add pages and forms in parallel; whichever lands second adds its page to the test's list. Suggested: mason.

commented

Reviewed pull #78 at its head: ticked A new src/a11y.test.ts renders, signed in on the sample deals: the clock (/, and /?q= with no match), a deal page, the client timeline, new deal (/deals/new), a refused page, and the signed-out welcome page. For each it checks, with plain string/regex parsing (no new dependency): <html lang> is set; exactly one <h1>; heading levels never skip (h2 → h4); every <input>, <select> and <textarea> other than type=hidden has a <label for> matching its id, a wrapping <label> or an aria-label; every <button> and <a> has visible text or an aria-label; no tabindex above 0; ids are unique on the page.; Whatever the test finds today is fixed in the same pull, in the page modules, without changing what a sighted user sees.; The layout has a "Skip to content" link as the first focusable element, visible on focus, pointing at <main id>; :focus-visible shows a clear outline on buttons, links and fields (using tokens from src/tokens.ts, so bun scripts/design-lint.ts passes).; The live clock refresh (/events) announces changes politely (aria-live="polite" on the region it updates) and does not move focus.; README gains one line under "What is real" saying the pages are checked for keyboard and screen-reader use..

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs