Inspiration
Accessibility bugs can hide in plain sight. A missing label, low-contrast text, or keyboard trap can turn an ordinary digital experience into a frustrating one. Phantom Audit makes invisible barriers visible through a playful Halloween-inspired interface, combining a spooky aesthetic with practical guidance.
What it does
Phantom Audit is a privacy-first HTML accessibility inspector. Paste or load sample HTML, scan it, and explore findings by severity. Each issue explains what was detected, why it matters, and a suggested remediation. The interface includes a clean sample for comparison, recent scan summaries, and exportable JSON reports.
Key features
- 11 deterministic, WCAG-informed heuristics for common HTML accessibility pitfalls.
- Severity-based findings, guidance, and illustrative code fixes.
- Responsive, spooky dashboard designed to make issue triage memorable.
- Intentionally flawed and clean sample pages for a repeatable demo.
- Browser-local scanning; source HTML is not uploaded.
- JSON findings export without the scanned source HTML.
How we built it
The application uses semantic HTML, CSS, and vanilla JavaScript. It parses supplied markup in the browser, applies explainable checks, and maps findings to actionable recommendations. The repository includes structured requirements, design, task, steering, and hook configuration under the root .kiro directory. These files document the intended Kiro-assisted workflow; they do not by themselves demonstrate that Kiro executed it.
Challenges
The main design challenge was balancing a distinctive Halloween visual identity with usable contrast, hierarchy, keyboard behavior, and legibility. On the engineering side, a heuristic scanner must offer meaningful signals without implying that automated checks certify WCAG compliance. We kept each result transparent and processing local.
What we learned
Accessibility tools are most valuable when they connect a concrete finding with a clear explanation and practical next step. A playful theme can attract attention, but it must stay secondary to usability.
What's next
Expand the checks with deeper context awareness, add broader test coverage, and improve reporting for designers and engineers.
Important scope note
Phantom Audit is an educational heuristic scanner, not a complete accessibility audit or a WCAG compliance certification. Pair automated checks with keyboard and screen-reader testing and evaluation by people with disabilities.
Live app: https://phantom-audit-kiroween26.usefulotter1.chatgpt.site/
Source: https://github.com/samertall/phantom-audit
AI tools disclosure
ChatGPT assisted with planning, drafting, and implementation. Phantom Audit itself runs deterministic accessibility checks locally in the browser and does not call a generative AI model at runtime. The included Kiro specification files are preparatory artifacts, not evidence of an authenticated Kiro execution session.
