Make a Mini-App Work With Keyboard, Zoom, and Screen Readers helps mini-app users and creators test the complete task against practical accessibility needs. It addresses helping people run, publish, and remix small apps without ignoring permissions, secrets, accessibility, licensing, and abuse. The goal is a usable decision record, checklist, or conversation—not a polished claim that outruns the evidence.
The decision this guide should improve
A useful guide changes a real decision. For this topic, the decision is whether and how to test the complete task against practical accessibility needs. Name who owns that call, the options they can choose, the deadline, and what would make them change course.
Keep observations separate from assumptions. An official source can explain a standard or risk, but it cannot prove what happened in your particular product, portfolio, job, home, or mini-app. Direct evidence needs its own date, subject, method, and limitation.
Use these current primary sources
The workflow below is grounded in W3C: WCAG overview, W3C: WCAG 2.2 quick reference. Open the source that supports the exact claim you need, confirm its scope and update date, and record where it does not apply. A smaller claim-to-source map is more useful than a decorative bibliography.
Five-step workflow
- 1. Use semantic names and relationships. Write the evidence, owner, date, and next decision beside the step.
- 2. Complete the task with keyboard only. Write the evidence, owner, date, and next decision beside the step.
- 3. Keep focus visible and logically ordered. Write the evidence, owner, date, and next decision beside the step.
- 4. Test zoom, reflow, contrast, and motion. Write the evidence, owner, date, and next decision beside the step.
- 5. Announce errors and dynamic results. Write the evidence, owner, date, and next decision beside the step.
Do the steps in order the first time. If a safety, privacy, financial, health, legal, or authorization boundary appears, pause the workflow. More activity is not progress when the prerequisite is missing.
Worked example
A quiz works by mouse but not keyboard because answer cards are plain divs. The creator changes them to real controls, adds focus treatment and error text, and tests the result at mobile width and 200% zoom.
The useful pattern is the visible chain from context to evidence to decision. Another person should be able to understand what was observed, what remained uncertain, and why the next action was proportionate.
Decision record
| Field | What to record |
|---|---|
| Subject | Exact user, workflow, account, role, home, app, strategy, or environment |
| Baseline | Current behavior before the change |
| Evidence | Source, direct observation, date, and method |
| Boundary | Safety, trust, cost, permission, or quality stop condition |
| Decision | Proceed, revise, seek qualified help, park, or stop |
| Review | Owner, next action, and date |
Common failure patterns
- Starting with a tool. Start with the user outcome and choose the lightest tool that produces credible evidence.
- Treating exposure as destiny. A risk, score, or capability describes a condition; it does not predict every outcome.
- Moving the threshold afterward. Set success and stop conditions before seeing the result.
- Hiding exceptions. Preserve manual corrections, failures, disagreements, and missing data.
- Reporting activity as impact. A click, test run, generated answer, or submitted form is not automatically the user outcome.
Questions for a second reviewer
- Which statement is most likely to be wrong?
- Which evidence is direct, and which is inferred?
- Does every requested permission or data field support the stated job?
- Who bears the cost of a false positive or false negative?
- What would cause us to stop proudly?
- Can someone reproduce the result from this record?
Sources and review note
Source links reviewed 2026-07-13. Follow each publisher for revisions and confirm that the guidance applies to your location and situation.