# github/accessibility-scanner architecture

> Architecture diagram of the GitHub repository github/accessibility-scanner, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/github/accessibility-scanner
- Repository: https://github.com/github/accessibility-scanner

## Overview

The product is a GitHub Action that scans configured sites or repositories for accessibility findings, files trackable GitHub issues, and can optionally involve Copilot in proposing fixes and opening pull requests. The README also documents plugin scans, authentication, screenshots, caching, and issue grouping/filtering; these are represented as capabilities without assuming unsampled implementation details. Source excerpts were not provided, so relationships are limited to those explicitly described in the README.

Main entry points: [`.github/actions/find/src`](https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src) (Scan orchestration), [`.github/actions/file/src`](https://github.com/github/accessibility-scanner/tree/main/.github/actions/file/src) (Issue filing), [`action.yml`](https://github.com/github/accessibility-scanner/blob/main/action.yml) (Scanner action), [`.github/actions/fix/src`](https://github.com/github/accessibility-scanner/tree/main/.github/actions/fix/src) (Copilot assignment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scan["Scanning"]
  node_action["Scanner action<br/>[action.yml]"]
  node_scan_runtime["Scan orchestration<br/>[src]"]
  node_auth["Scan authentication<br/>[src]"]
  node_screenshots["Screenshots"]
  node_findings["Accessibility findings<br/>[src]"]
end

subgraph group_engines["Scan engines"]
  node_axe["Axe engine<br/>[src]"]
  node_accesslint["AccessLint engine<br/>[src]"]
  node_plugins["Scan plugins<br/>[pluginManager]"]
end

subgraph group_issues["Issue management"]
  node_issue_filing["Issue filing<br/>[src]"]
  node_issue_state["Issue lifecycle<br/>[src]"]
end

subgraph group_fixes["Fix workflow"]
  node_fix_assignment["Copilot assignment<br/>[src]"]
  node_fix_pr["Fix pull requests<br/>[src]"]
end

node_workflow(("GitHub Actions workflow"))
node_targets["Websites and repositories"]
node_github_issues[("GitHub Issues")]
node_copilot["GitHub Copilot"]
node_reviewer(("Human reviewer"))

node_workflow -->|"runs"| node_action
node_action -->|"starts scan"| node_scan_runtime
node_scan_runtime -->|"scans"| node_targets
node_scan_runtime -.->|"authenticates"| node_auth
node_scan_runtime -->|"runs scan"| node_axe
node_scan_runtime -->|"runs scan"| node_accesslint
node_scan_runtime -->|"loads plugins"| node_plugins
node_scan_runtime -->|"captures optionally"| node_screenshots
node_scan_runtime -->|"detects"| node_findings
node_findings -->|"files"| node_issue_filing
node_issue_filing -->|"creates issues"| node_github_issues
node_issue_state -->|"updates issues"| node_github_issues
node_issue_filing -.->|"tracks filings"| node_issue_state
node_github_issues -->|"assigns optionally"| node_fix_assignment
node_fix_assignment -->|"assigns to"| node_copilot
node_copilot -->|"proposes fixes"| node_fix_pr
node_fix_pr -->|"awaits review"| node_reviewer

click node_action "https://github.com/github/accessibility-scanner/blob/main/action.yml"
click node_scan_runtime "https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src"
click node_auth "https://github.com/github/accessibility-scanner/tree/main/.github/actions/auth/src"
click node_screenshots "https://github.com/github/accessibility-scanner/blob/main/.github/actions/find/src/generateScreenshots.ts"
click node_axe "https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src"
click node_accesslint "https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src"
click node_plugins "https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src/pluginManager"
click node_findings "https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src"
click node_issue_filing "https://github.com/github/accessibility-scanner/tree/main/.github/actions/file/src"
click node_issue_state "https://github.com/github/accessibility-scanner/tree/main/.github/actions/file/src"
click node_fix_assignment "https://github.com/github/accessibility-scanner/tree/main/.github/actions/fix/src"
click node_fix_pr "https://github.com/github/accessibility-scanner/tree/main/.github/actions/fix/src"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_action,node_scan_runtime,node_auth,node_screenshots,node_findings,node_reviewer toneBlue
class node_axe,node_accesslint,node_plugins,node_github_issues toneAmber
class node_issue_filing,node_issue_state toneMint
class node_fix_assignment,node_fix_pr toneRose
class node_workflow,node_targets,node_copilot toneIndigo
```

## Components

### Scanning

- [Scanner action](https://github.com/github/accessibility-scanner/blob/main/action.yml): `action.yml`
- [Scan orchestration](https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src): `.github/actions/find/src`
- [Scan authentication](https://github.com/github/accessibility-scanner/tree/main/.github/actions/auth/src): `.github/actions/auth/src`
- [Screenshots](https://github.com/github/accessibility-scanner/blob/main/.github/actions/find/src/generateScreenshots.ts): `.github/actions/find/src/generateScreenshots.ts`
- [Accessibility findings](https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src): `.github/actions/find/src`

### Scan engines

- [Axe engine](https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src): `.github/actions/find/src`
- [AccessLint engine](https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src): `.github/actions/find/src`
- [Scan plugins](https://github.com/github/accessibility-scanner/tree/main/.github/actions/find/src/pluginManager): `.github/actions/find/src/pluginManager`

### Issue management

- [Issue filing](https://github.com/github/accessibility-scanner/tree/main/.github/actions/file/src): `.github/actions/file/src`
- [Issue lifecycle](https://github.com/github/accessibility-scanner/tree/main/.github/actions/file/src): `.github/actions/file/src`

### Fix workflow

- [Copilot assignment](https://github.com/github/accessibility-scanner/tree/main/.github/actions/fix/src): `.github/actions/fix/src`
- [Fix pull requests](https://github.com/github/accessibility-scanner/tree/main/.github/actions/fix/src): `.github/actions/fix/src`

### Other components

- **GitHub Actions workflow**
- **Websites and repositories**
- **GitHub Issues**
- **GitHub Copilot**
- **Human reviewer**

## Connections

- GitHub Actions workflow → Scanner action: runs (evidence: `README.md`)
- Scanner action → Scan orchestration: starts scan (evidence: `README.md`)
- Scan orchestration → Websites and repositories: scans (evidence: `README.md`)
- Scan orchestration → Scan authentication: authenticates
- Scan orchestration → Axe engine: runs scan (evidence: `README.md`)
- Scan orchestration → AccessLint engine: runs scan (evidence: `README.md`)
- Scan orchestration → Scan plugins: loads plugins (evidence: `README.md`)
- Scan orchestration → Screenshots: captures optionally (evidence: `README.md`)
- Scan orchestration → Accessibility findings: detects (evidence: `README.md`)
- Accessibility findings → Issue filing: files (evidence: `README.md`)
- Issue filing → GitHub Issues: creates issues (evidence: `README.md`)
- Issue lifecycle → GitHub Issues: updates issues (evidence: `README.md`)
- Issue filing → Issue lifecycle: tracks filings
- GitHub Issues → Copilot assignment: assigns optionally (evidence: `README.md`)
- Copilot assignment → GitHub Copilot: assigns to (evidence: `README.md`)
- GitHub Copilot → Fix pull requests: proposes fixes (evidence: `README.md`)
- Fix pull requests → Human reviewer: awaits review (evidence: `README.md`)
