WCAG Audit Service
Component Detail
Description
Backend-coupled CI service that runs flutter_accessibility_lints and Semantics tree diffing on every pull request to gate merges on WCAG 2.2 AA compliance. It validates contrast ratios from the Design Token System at build time and generates a structured accessibility report per widget tree snapshot. Manual VoiceOver and TalkBack smoke-test checklists are also managed through this service's release gate configuration.
wcag-audit-service
Sources & reasoning
Compliance from day one requires automated enforcement - manual review is insufficient across 59 features and ongoing development. The WCAG Audit Service operationalizes the absolute MVP requirement by blocking non-compliant code at the PR stage. Contrast validation at design-token level catches violations before they propagate to screens, while Semantics tree diffing prevents accessibility regressions when widget trees are refactored.
No source references — this artifact was included based on reasoning alone (see above).
Responsibilities
- Run flutter_accessibility_lints on every PR and block merge on violations
- Perform Semantics tree diffing in widget tests to detect label regressions
- Validate color token contrast ratios against WCAG 4.5:1 (normal text) and 3:1 (large text/UI) thresholds
- Manage release-gate checklist for physical-device VoiceOver (iOS) and TalkBack (Android) smoke tests
- Generate structured accessibility compliance reports per build
Interfaces
runLintCheck(pullRequestId: String): LintReport
diffSemanticsTree(before: SemanticsSnapshot, after: SemanticsSnapshot): DiffResult
validateContrastTokens(tokenSet: DesignTokenSet): ContrastReport
getReleaseGateStatus(releaseId: String): GateStatus
Relationships
Related Data Entities (2)
Data entities managed by this component