a11yGuard

Accessibility
that ships with every PR

a11yGuard runs accessibility checks on every pull request. New code stays compliant while ignoring preexisting issues.

Get startedHow It Works

The Problem

Over 95% of websites do not comply with Web Content Accessibility Guidelines (WCAG). Millions of users who rely on assistive tech, keyboard navigation, or clear contrast are left unable to effectively understand and utilize the important information on billions of sites. For developers, keeping track of up-to-date regulations and checking manually with each new push is cumbersome and unsustainable.

How It Works

  1. 1a11yGuard builds your base branch and PR branch on every PR
  2. 2Runs axe-core on both via Playwright
  3. 3Diffs results with new violations flagged, resolved ones highlighted and accepted
  4. 4Posts a structured comment, then Gemini-3 reviews the violations and fixes the issues

Step-by-step setup

Add one workflow file. No scripts, no extra config.

1. Create .github/workflows/a11y.yml

Copied
name: Accessibility Regression Check

on:
  pull_request:

jobs:
  a11y:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
    steps:
      - name: Run accessibility check
        uses: zachkklein/WCAG_PR_Checker@v2
        with:
          APP_DIR: '.'
          BUILD_DIR: 'public'
          URLS: '/'
          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}

For more details on inputs and customizations, find us on GitHub Marketplace

See It In Action