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.

Built With

Share this project:

Updates

Submission history