Wire axle into the tools your team uses

The axle GitHub Action posts a sticky comment on every pull request with the full violation breakdown. AI-fix diffs (with with-ai-fixes: true) appear inline in the same comment. No setup beyond adding the workflow file.

Each hosting provider has a dedicated plugin (axle-vercel-plugin, axle-netlify-plugin, axle-cloudflare-plugin) that runs against the preview URL on every deploy and fails the build on serious-severity regressions. See the docs for setup.

axle's GitHub Action exposes the scan output as job outputs. Pipe it into Slack with the standard slackapi/slack-github-action:

- uses: asafamos/axle-action@v1
  id: axle
  with:
    url: ${{ secrets.PREVIEW_URL }}
    fail-on: serious

- if: ${{ failure() && steps.axle.outputs.failing == 'true' }}
  uses: slackapi/slack-github-action@v2
  with:
    channel-id: 'C0XXXXXXX'
    payload: |
      {
        "text": ":warning: a11y regression on ${{ github.event.pull_request.html_url }}",
        "blocks": [
          {
            "type": "section",
            "text": {
              "type": "mrkdwn",
              "text": "*axle CI failed on PR #${{ github.event.pull_request.number }}*\nPRevent merge until WCAG violations resolved."
            }
          }
        ]
      }
  env:
    SLACK_BOT_TOKEN: ${{ secrets.SLACK_BOT_TOKEN }}

Parse the JSON output and POST to Linear's GraphQL API. Each serious or critical violation becomes a Linear issue tagged a11y. Use the issue title pattern [a11y] <rule_id> on <page_path> so duplicates are auto-merged when the rule appears on the same path next scan:

- uses: asafamos/axle-action@v1
  id: axle
  with:
    url: ${{ secrets.PREVIEW_URL }}
    json-out: axle-report.json

- if: ${{ steps.axle.outputs.failing == 'true' }}
  run: |
    cat axle-report.json | jq -c '.violations[] | select(.impact == "serious" or .impact == "critical")' | while read v; do
      title="[a11y] $(echo "$v" | jq -r '.id') on /${{ github.head_ref }}"
      body=$(echo "$v" | jq -r '"WCAG: " + (.tags | join(", ")) + "\n\n" + .help + "\n\nFix: " + .helpUrl')
      curl -s -X POST "https://api.linear.app/graphql" \
        -H "Authorization: ${{ secrets.LINEAR_API_KEY }}" \
        -H "Content-Type: application/json" \
        -d "{\"query\":\"mutation { issueCreate(input: { teamId: \\\"${{ secrets.LINEAR_TEAM_ID }}\\\", title: \\\"$title\\\", description: \\\"$body\\\", labelIds: [\\\"${{ secrets.LINEAR_A11Y_LABEL }}\\\"] }) { success } }\"}"
    done

Jira's REST API (POST /rest/api/3/issue) takes a similar JSON payload. Authenticate with a Jira API token + email pair as Basic auth. The same violation-to-issue script structure works — just swap the Linear GraphQL call for the Jira REST call. Email asaf@amoss.co.il if you want a starter template for your specific Jira workflow.

Use the axle-cli npm package directly in.gitlab-ci.yml:

a11y:
  image: node:20
  stage: test
  script:
    - npx axle-cli scan $PREVIEW_URL --fail-on serious
    - mv axle-report.json gitlab-a11y-report.json
  artifacts:
    when: always
    reports:
      junit: gitlab-a11y-report.json
    paths:
      - gitlab-a11y-report.json