Ariada · Open Source · Documentation

CI Gate Dashboard — differential accessibility status for pull requests

A visual dashboard that surfaces the Ariada differential CI gate result as a GitHub check — showing new violations, pre-existing counts, and gate status at a glance.

CI/CD integration surface OSS gate: EUPL-1.2 · Free Status: design mockup — no operational dashboard ships yet

What this module is

Status: design mockup — not yet shipped. The screenshots below show the target design for the pull-request check card and the developer-facing gate dashboard. The OSS differential gate schema (@ariada-org/diff-schema + diff-stub) is real and published. The operational dashboard UI shown here does not yet exist as shipped code.

The Ariada CI gate dashboard is the developer-facing read surface for the differential accessibility gate: a pull-request check card (GitHub Checks API) plus a companion web dashboard that breaks down new violations, pre-existing tracked findings, and the pass / block decision — without burying the developer in a wall of axe-core JSON.

Is this a design mockup? Yes — the dashboard UI is a design specification, not shipped code. The underlying gate logic (@ariada-org/diff-schema + diff-stub + diff-action) is real and published on npm. The operational dashboard is the roadmap for a future product that is not yet launched.
Type
GitHub Checks API card + companion web dashboard (design specification)
OSS layer
@ariada-org/diff-schema + diff-stub + diff-action — equality-only gate; real and published
Status
Dashboard: design mockup only. Gate packages: published at 0.1.0 with Sigstore provenance.

Who uses it & why

RoleHow they use itValue
Frontend / QA developerSees a pass/block signal on every PR without reading raw axe JSONHigh — reduces review friction
Engineering leadSets differential thresholds (new-violations-only vs all) per repositoryHigh
Accessibility engineerDrills into the new-vs-pre-existing breakdown; tracks regression over timeHigh
Compliance teamUses the gate log as an audit trail for EAA / ADA compliance evidenceMedium-High

The gate dashboard turns the scanner's output into a blocking CI signal: developers cannot merge a PR that introduces new accessibility violations without an explicit bypass decision by an authorized reviewer.

Distribution — free and open source

The OSS differential gate — the schema, the equality-only classifier, and the GitHub Action — are free and open source under the EUPL-1.2 licence. No account is required to use the equality-only gate in your CI pipeline.

CapabilityAvailability
Fingerprint + selector-normalise for equality comparisonOpen source
Equality-only pass / block gateOpen source
Composite GitHub Action wrapping the gateOpen source

Getting started

  1. Install — the diff-action is published on npm and the GitHub Actions marketplace.
  2. Add to CI — add the Action to an existing CI workflow; it produces a pass/block gate on every pull request.
  3. Configure — set thresholds and baseline snapshots per repository; the gate output doubles as an EAA compliance audit-trail entry.
  4. Extend — the schema and stub are open source; you can extend the equality-only gate with custom rules.

Documentation & help — current state

Action usage
uses: ariada-org/diff-action@v0.1 — see the README for the required scan-result input and the gate-result output.
Docs site
apps/docs (Astro Starlight) needs a "CI Gate" page: install → configure baseline → read the check card → handle a block.
Dashboard docs
Not yet written — the dashboard itself is not yet shipped.

AI chat & digital-adoption helpers — plan

Honest status: the OSS gate packages have no AI features. Distinguishing human-authored regressions from AI-tool-introduced violations is a separate capability that is not part of the open packages documented on this page.

Screenshots — click any image to open it full size

From the end-to-end Playwright harness. Each thumbnail opens a full-size, zoomable overlay.

GitHub check card — passing state: green badge, 0 new violations, pre-existing count shown
1 · CI check — passing
GitHub check card — blocked state: red badge, N new violations listed by severity
2 · CI check — blocked
Dashboard desktop view — differential summary: new vs pre-existing counts, trend sparkline
3 · Dashboard — desktop
Dashboard mobile view — stacked cards, gate status badge prominent
4 · Dashboard — mobile

Assessment summary

Full assessment is in assessment.html. Headline: the design mockup follows GitHub Checks API conventions and Codecov / SonarCloud patterns for PR comment summaries. Key gap: the dashboard is a design specification only — no operational code ships yet. The OSS gate packages are real.

Full detail in assessment.html.