Skip to content

devopsabcs-engineering/accessibility-scan-workshop

Repository files navigation

title Accessibility Scan Workshop
description Hands-on workshop teaching WCAG 2.2 accessibility scanning using axe-core, IBM Equal Access, and custom Playwright checks
ms.date 2026-03-29

Accessibility Scan Workshop

Note

This workshop is part of the Agentic Accelerator Framework.

Hands-on workshop teaching WCAG 2.2 accessibility scanning using axe-core, IBM Equal Access, and custom Playwright checks. Students learn to detect, report, and remediate accessibility violations across 5 intentionally inaccessible demo web applications built in Rust, C#, Java, Python, and Go.

Architecture

graph LR
    subgraph "Demo Apps (5)"
        A001["001 Rust<br/>Travel Agency"]
        A002["002 C#<br/>E-Commerce"]
        A003["003 Java<br/>Learning Platform"]
        A004["004 Python<br/>Recipe Sharing"]
        A005["005 Go<br/>Fitness Tracker"]
    end

    subgraph "Scan Engines"
        AXE["axe-core"]
        IBM["IBM Equal Access"]
        CUSTOM["Custom Playwright Checks"]
    end

    subgraph "Output"
        SARIF["SARIF 2.1.0"]
        JSON["JSON Reports"]
        PDF["PDF Reports"]
    end

    subgraph "Integration"
        GH["GitHub Security Tab"]
        ACTIONS["GitHub Actions"]
        COPILOT["Copilot Agents"]
    end

    A001 & A002 & A003 & A004 & A005 --> AXE & IBM & CUSTOM
    AXE & IBM & CUSTOM --> SARIF & JSON & PDF
    SARIF --> GH
    ACTIONS --> AXE & IBM & CUSTOM
    COPILOT --> GH
Loading

Labs

Lab Title Duration Level
00 Prerequisites and Environment Setup 30 min Beginner
01 Explore the Demo Apps and WCAG Violations 25 min Beginner
02 axe-core — Automated Accessibility Testing 35 min Intermediate
03 IBM Equal Access — Comprehensive Policy Scanning 30 min Intermediate
04 Custom Playwright Checks — Manual Inspection Automation 35 min Intermediate
05 SARIF Output and GitHub Security Tab 30 min Intermediate
06 GitHub Actions Pipelines and Scan Gates 40 min Advanced
07 Remediation Workflows with Copilot Agents 45 min Advanced

Lab Dependency Diagram

graph LR
    L00[Lab 00: Setup] --> L01[Lab 01: Demo Apps]
    L01 --> L02[Lab 02: axe-core]
    L01 --> L03[Lab 03: IBM Equal Access]
    L01 --> L04[Lab 04: Custom Checks]
    L02 --> L05[Lab 05: SARIF]
    L03 --> L05
    L04 --> L05
    L05 --> L06[Lab 06: GitHub Actions]
    L06 --> L07[Lab 07: Remediation]
Loading

Labs 02, 03, and 04 can be completed in any order after Lab 01.

Delivery Tiers

Tier Labs Duration Azure Required
Half-Day 00, 01, 02, 03, 05 ~3 hours No
Full-Day 00–07 (all) ~6.5 hours Yes

Tool Stack

Tool Purpose
axe-core WCAG 2.2 automated rule checking
IBM Equal Access Policy-based accessibility scanning
Custom Playwright Checks Manual inspection automation
SARIF Static Analysis Results Interchange Format

Prerequisites

  • GitHub account with Copilot access
  • Node.js 20+
  • Docker Desktop
  • Azure subscription (full-day tier only)
  • PowerShell 7+
  • GitHub CLI (gh)
  • Azure CLI (az) (full-day tier only)

Quick Start

  1. Fork and clone devopsabcs-engineering/accessibility-scan-demo-app
  2. Run npm install && npx playwright install --with-deps chromium
  3. Start the scanner: ./start-local.ps1
  4. Open Lab 00 and begin

Contributing

See CONTRIBUTING.md for lab authoring guidelines.

License

MIT

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages