A11yKit senior-first UI kit
Source
Display

WCAG 2.2 AAA contrast · 10 MIT components · MCP server inside

Screens your parents can actually use.

Targets above 48px, 18.4:1 body contrast, tap sounds synthesized with zero audio files — plus a local MCP server that makes Claude Code and Cursor build it right the first time.

  • 18 components
  • 0 dependencies, external scripts
  • 18.4:1 body contrast
Live on this page Sound on

Good morning, Mrs. Lee

Wednesday 18 November · 8:30

Those buttons are real code running here. Sound is synthesized by the browser; speech uses your device voice.

Live Every demo runs here — not a screenshot.
Code Copy one HTML file, or a single React component.
Prompt A precise prompt that reproduces the component in Claude Code or Cursor.
Verify check_wcag_checklist returns the manual checks for each criterion.

Cursor · Claude Code · Copilot · Windsurf · AGENTS.md

AI ships bad senior UI because nobody gave it rules.

Drop one file into your repo and 48px targets and 18.4:1 contrast stop being a memory and start being a rule. The same content, formatted for five tools — open your tool's tab, copy it or save the file.

All five files

What is in the file

  1. Every target 48px or larger, primary actions 56–64px, 12px between neighbours. Grow hit areas with padding.
  2. Body contrast 7:1 or better (AAA) — this kit measures 18.4:1. Secondary text stays above 4.5:1.
  3. Focus ring 4px #FFE066 with a 3px offset, keyboard focus only, never clipped.
  4. State is never colour-only — an icon, a word, weight or underline always joins it.
  5. Status changes go to role=status; only errors use role=alert, so a screen reader hears the same fact.
  6. Real button, a, input and dialog; labels above fields, tied with for/id; a placeholder is never the label.
  7. Sound is optional: Web Audio only, one tone per 80ms, mute remembered, every cue also in text.
  8. Survives 200% zoom and 320px width with no horizontal scroll; prefers-reduced-motion respected.

The rules take WCAG 2.2 AA as the floor and push contrast, targets and focus to AAA. They are short on purpose so they sit on top of your project's own conventions.

Save as .cursor/rules/a11y-senior-ui.mdc

Why senior UI is a different problem

Most design systems are tuned for a 25-year-old thumb. This one moves the baseline.

Sized for a shaking hand

A 48px floor, 56–64px for primary actions, 12px between targets — above the 44px that WCAG 2.5.5 (AAA) requires.

Readable when eyes blur

Body text at 18.4:1 and secondary text at 10.6:1, past the 7:1 AAA bar. State never relies on colour alone — icon and sentence come with it.

Feedback you can hear

A 40 ms tone synthesized with Web Audio. No mp3, no download. Sound can be switched off, and every cue is mirrored by visible text and a screen-reader announcement.

Correct by construction for AI

The MCP server hands your agent the code, the implementation prompt and the WCAG checklist directly, so it stops guessing from memory.

Catalog · 18 components

Ten are MIT and free. Eight are Pro — their cards show the preview and the spec, not the source.

Big action buttons + tap sound

Free · MIT

56px tall, a 4px yellow focus ring, and a 40 ms synthesized tone so the press lands in eye and ear at once.

Nothing pressed yet.

  • WCAG 2.5.5 AAA
  • 1.4.6 AAA
  • 2.1.1
  • 4.1.3
  • 0 KB sound

Text scale + contrast switch

Free · MIT

Three text sizes and a high-contrast mode that apply instantly and survive a reload.

This card

8:30 AM

One blood-pressure tablet with a glass of water.

Any time within 30 minutes after breakfast.

  • 1.4.4
  • 1.4.8 AAA
  • 2.4.7 AAA
  • 4.1.2
  • localStorage

Medication checklist

Free · MIT

Three doses a day as 48px rows. One tap marks it taken, announces it to screen readers and keeps a visible count.

Wednesday 18 Nov

0 of 3 taken

  • 1.3.1
  • 2.5.5 AAA
  • 4.1.3
  • 1.4.6 AAA
  • state kept

Kiosk choice list

Free · MIT

One 64px choice per row with arrow-key focus and the choice announced aloud.

How can we help?

Nothing selected.

  • 2.5.5 AAA
  • 2.1.1
  • 3.3.2
  • 4.1.2
  • arrow keys

Read aloud button

Free · MIT

`speechSynthesis` with rate control and a stop button — the text stays on screen while it is spoken.

Your appointment is Thursday 20 November at 2:30 PM with Dr. Park, room 302. Please bring your ID card.

  • 1.1.1
  • 4.1.3
  • 1.4.5
  • device voices

Two-step confirm switch

Free · MIT

A native `dialog` in two steps — the destructive button arms only after you move the switch yourself.

Delete 14 photos from the family album?

Step 1 of 2

Delete 14 photos

Deleted photos leave the bin after 30 days.

  • 3.3.4 AAA
  • 3.3.6 AAA
  • 2.4.3
  • 4.1.2
  • focus return

Big number keypad

Free · MIT

64px keys, a 4px focus ring and a masked display that announces the length as you type.

Demo only — nothing is sent.

  • 2.5.5 AAA
  • 2.4.7 AAA
  • 4.1.2
  • 1.4.11
  • 64px keys

Success and error banners

Free · MIT

Icon, heading, one plain sentence. Success and error get different tones; only errors interrupt as `role="alert"`.

  • 1.4.1
  • 4.1.3
  • 3.3.1
  • 1.4.6 AAA
  • tone per state

Step progress

Free · MIT

Four numbered stages, a filling track and `aria-current` — a screen reader says exactly where you are.

  1. 1Identity
  2. 2Symptoms
  3. 3Time
  4. 4Confirm

Step 1 of 4 · Identity

  • 1.3.1
  • 2.4.8 AAA
  • 4.1.2
  • 1.4.11
  • live step text

Senior-friendly form

Free · MIT

Labels fixed above fields, 56px inputs, an error summary that links to each field, messages written as sentences.

Digits only, for example 01012345678

  • 3.3.1
  • 3.3.3 AAA
  • 1.3.1
  • 3.3.2
  • error summary

Family check-in card

Pro

One press sends “I’m okay”, and the family side keeps the last-seen time.

Mother · checked in 8:12 AM

I’m okay Need a call Later

3 days in a row · 1 reminder today

Preview only — source and MCP access are Pro

  • One-tap reply with large status text and retry on failure
  • Web Push and SMS handoff documented, no vendor lock-in
  • WCAG 2.5.5 AAA · 3.3.4 AAA · 4.1.3

Hospital timeslots

Pro

60px slots grouped by morning and afternoon, with doctor and room, confirmed by a press-and-hold.

Morning

9:009:3010:00

Afternoon

13:3014:0014:30

Dr. Park · room 302 · 30 min

Preview only — source and MCP access are Pro

  • 60px slots; selection shown by icon and weight, not colour alone
  • 1.2 s hold-to-confirm stops mis-taps
  • WCAG 2.5.5 AAA · 2.5.2 · 1.4.1

Large-print receipt

Pro

18pt or larger on both 80 mm receipt paper and A4, with items, tax and total. Print CSS included.

Wando Pharmacy

Blood pressure 5 mg₩8,400

Vitamin D₩6,600

Total₩15,000

18 Nov 2026 · 8:41 AM

Preview only — source and MCP access are Pro

  • @media print layouts for 80 mm and A4 with an 18pt floor
  • Right-aligned amounts with grouped digits and an emphasised total
  • WCAG 1.4.8 AAA · 1.4.6 AAA · 1.3.1

Multilingual TTS pack

Pro

Fixed phrases in Korean, English, Japanese and Chinese read by the device voice, with a large-text fallback when no voice exists.

KO줄을 서 주세요

ENPlease form a line

JA列にお並びください

ZH请排队

Preview only — source and MCP access are Pro

  • 40 phrases, language auto-selection, rate and pitch presets
  • Voice availability check with a large-text fallback
  • WCAG 3.1.2 · 1.2.1 · 4.1.2

Vitals trend

Pro

Blood pressure, pulse and weight as large numbers with a 7-day trend, and a plain word beside each value so colour is never the only cue.

Blood pressure128/82Normal

7-day average 126/80 · 2 lower than yesterday

Preview only — source and MCP access are Pro

  • 40pt numbers, a status word beside each, plus the same data as a table
  • 7- and 30-day sparklines with honest empty states
  • WCAG 1.4.1 · 1.1.1 · 1.4.8 AAA

Hold to pay

Pro

The amount is spoken aloud, and payment proceeds only after a 3-second hold; lifting the finger cancels.

₩12,000

Clinic fee · card

Hold for 3 seconds

Preview only — source and MCP access are Pro

  • Pointer and keyboard hold, cancel on release or Escape
  • Amount spoken aloud, input locked while paying
  • WCAG 2.5.2 · 3.3.4 AAA · 2.5.5 AAA

screen × user → components + prompt

Pick the screen. The combination and the prompt follow.

From kiosk ordering to care records: choose a screen and who uses it, and this builds the component combination plus a prompt you can paste straight into Claude Code or Cursor, with the target's constraints and acceptance criteria baked in.

2. Who uses it? (choose any)

This screen needs

    Paste-ready prompt

    Need an institutional audit, a full accessibility pass or the finished screens? The parts the combination cannot cover can be built for you.

    local stdio · nothing leaves your machine

    An MCP server, not a PDF.

    Your agent asks for the code, the implementation prompt or the WCAG checklist and gets it — no network calls, no API keys.

    Server source

    Four tools

    list_components
    Filter all 18 by tier, tag or keyword. Each row carries its WCAG criteria and status.
    get_component
    Returns HTML+CSS+JS, React source and accessibility notes for one id. Pro ids return the spec and a lock notice, never the source.
    get_ai_prompt
    Builds a paste-ready prompt for Claude Code, Cursor or Lovable.
    check_wcag_checklist
    Returns the criteria that apply, with the manual check a human must run for each.

    Needs Node 18+. The server talks over stdio only and only reads its own data file.

    Connect it · five clients

    Clone once, check it runs
    git clone --depth 1 https://github.com/doggonug-cpu/doggonug-cpu.github.io.git
    node doggonug-cpu.github.io/a11y-ui-kit/mcp/server.mjs --selftest

    One line in your terminal

    claude mcp add
    claude mcp add a11y-kit -- node /absolute/path/a11y-ui-kit/mcp/server.mjs
    30-second self-test
    printf '%s\n' \
      '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl-test","version":"1"}}}' \
      '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
      | node mcp/server.mjs

    Replace only the /absolute/path part (on Windows use forward slashes, e.g. C:/tools/…). The npm package is not published yet, so clients point at the cloned file; registry metadata is prepared in mcp/server.json.

    Pricing

    Checkout is not open yet. These buttons add you to the early-access list — no card details are collected.

    Free

    $0forever

    Ten components, ready to copy today. Commercial use allowed; attribution appreciated but not required.

    • 10 components · MIT licence
    • HTML+CSS+JS and React source
    • AI implementation prompts
    • MCP access to free components
    • WCAG checklists
    Start free

    First 200 seats

    Founding Forever

    $79one-time

    Pay once and keep every Pro component, including later releases. Closed at 200 seats.

    • All Pro components, no expiry
    • Future components included
    • No logo wall, no public customer list
    • Limited to 200 seats

    There is also a way to start before checkout opens: send a quote request for custom work, or browse the education and work material on the creator profile.

    When copying is not enough, that part can be built for you

    If the free ten get you most of the way and only the kiosk, care or public-sector screens are left, those screens can be rebuilt and handed over. Requests come through the form; the quote comes back within 24 hours by email.

    Send the form now and the launch price is written into the same reply — first come, first served; the amount appears in the quote itself.

    Accessibility review

    Your live screens are checked against WCAG 2.2 AA, and every fix comes back as a priority list with the code.

    • Keyboard and screen-reader pass
    • Contrast and target-size measurement
    • Fix snippets included

    Team and institution licence

    For repeated use across client sites or in-house training, write how many people and how many sites are involved.

    • Priced by number of sites
    • One internal training session can be included
    • Clear scope for Pro components

    The scope is checked first and the quote follows within 24 hours by email; budget, timing and deliverable are chosen in the form. Sending the form does not charge anything.

    Questions

    Is the free tier really MIT?

    Yes. The ten free components are published under MIT — copy them into commercial products, no attribution required. Pro source is separately licensed and only released to buyers.

    Do I need a build step?

    No. The HTML+CSS+JS version runs as one file, and the React version is a single-file component. This site itself ships with no framework, bundler or external script.

    Is this site itself WGAC AAA?

    Body text measures 18.4:1 and secondary text 10.6:1, past the 7:1 AAA bar; every control is at least 48px with a 4px focus ring. We do not claim automated AAA conformance for the whole page — AAA includes criteria such as sign-language and image-text levels that need a human review.

    Is the MCP server safe to run?

    It speaks over stdio only, reads one local `catalog.json` beside it, and makes no network requests, writes no files and needs no API keys. The source is public so you can read it first.

    What about Korean?

    Every component ships Korean and English label sets, and this page switches between EN and KO. The multilingual voice pack is part of Pro.

    Does it work without sound?

    All sound is optional. The switch in the header turns it off and remembers the choice; the same information is always carried by visible text and a screen-reader announcement.

    Can I pay now?

    Not yet. Until settlement is connected the buttons collect an early-access request instead. The list hears first when checkout opens, and nothing is charged before that.

    Can agencies and care providers use it?

    The free ten already are. If you apply these across client sites or need kiosk and care flows, Pro fits; note your team size in the list form and a team licence will be offered when checkout opens.

    Copy it today, ship it tomorrow.

    The ten free components are open right now — code, prompts and checklists included.

    Open the catalog