access-check

WCAG 2.2 accessibility auditor for HTML files, directories, and URLs — no browser needed.

Install

npx github:NickCirv/access-check index.html

No global install required. Works on static files, build output, and live URLs.

Usage

# Audit a single HTML file
npx github:NickCirv/access-check index.html

# Audit all HTML files in a directory
npx github:NickCirv/access-check ./dist/

# Audit a live URL
npx github:NickCirv/access-check https://example.com

Flag	Description
--level <A|AA|AAA>	WCAG conformance level (default: AA)
--format <terminal|md|json>	Output format (default: terminal)
--json	Alias for --format json
--strict	Exit code 1 on any violation — use in CI
--min-severity <level>	Only report at or above critical, serious, warning, or info

What it does

Parses raw HTML and runs 30+ WCAG 2.2 rules across images, structure, navigation, forms, and ARIA — no headless browser, no Chrome binary, no runtime. Works on static build artifacts, making it practical in CI pipelines where spinning up a browser isn't an option.

Checks include: missing alt text, unlabelled form inputs, skipped heading levels, missing lang attribute, invalid ARIA roles, broken aria-labelledby references, generic link text, and more.

CI Integration

# GitHub Actions
- name: Accessibility audit
  run: npx github:NickCirv/access-check ./dist/ --level AA --strict

Exit codes: 0 = no critical/serious violations · 1 = violations found (or any violation in --strict mode).

---

_{Node ≥18 · MIT · by NickCirv}