Gate CI with Real A11y CLI

Install in CI

npm i -D @real-a11y-dev/cli@beta playwright
npx real-a11y install

Simple gate

npx real-a11y audit http://localhost:3000

• Exit 1 on error-severity findings.
• Exit 2 (or non-zero failure) when the URL is unreachable — never treat network failure as a clean pass.
• Optional

  a11y.config.json

  with

  defaults

  and

  urls

  for multi-page runs.

PR regression (snapshot → diff)

1. On the base ref:

   real-a11y snapshot <url> --output base.json

   (or configured set)
2. On the PR ref:

   real-a11y snapshot <url> --output pr.json

3. real-a11y diff base.json pr.json

   — fails on new regressions
4. Use

   --format md

   for PR comments; optional

   --explain

   for structural hints (advisory only — do not treat as a hard signal alone)

--ignore-view-line

--session

Adopting on existing debt

real-a11y snapshot

audit

npx real-a11y snapshot --config a11y.config.json --update-baseline
npx real-a11y snapshot --config a11y.config.json \
  --baseline .a11y-baseline.json --fail-on error

--baseline

diff

Artifacts

sarif

junit

json

jsonl

Related

• One-off human/agent audit →

  audit-a-page

• In-suite snapshots →

  a11y-snapshot-tests