Clear11y
Automated web accessibility scanner using Axe, Playwright, and keyboard navigation testing for WCAG compliance reports.
Executive Summary
Challenge: Automate comprehensive accessibility testing beyond static analysis, including dynamic keyboard navigation checks that Axe alone cannot detect. Approach: Designed Clean Architecture pipeline coordinating specialized services—ZipService for archive processing, PlaywrightAxeService for WCAG rule injection, and custom KeyboardAccessibilityService that simulates tab navigation to detect focus traps and missing indicators. Architecture enforces strict layer separation (domain configs, application orchestration, infrastructure adapters). Key Innovation: Custom keyboard testing logic captures dynamic violations (tab sequences, focus visibility) missed by static analyzers. Report consolidation engine merges Axe + keyboard results into schema-validated HTML with Jinja templates. FastAPI server provides async job queuing via SQLAlchemy JobStore. Comprehensive pytest suite (unit/integration/E2E with golden tests) validates pipeline reliability. Used in CI/CD via GitHub Action integration.
The Challenge
Automates detection of web accessibility violations (Axe rules + keyboard navigation) in static sites or live URLs to ensure WCAG compliance.
The Solution
Pipeline coordinates services (ZipService, PlaywrightAxeService, KeyboardAccessibilityService); BrowserManager for concurrency. Monitoring middleware, stubs for tests.
System Architecture
Key Features
ZIP File Scanning
Axe Accessibility Scanning
Keyboard Navigation Testing
Report Generation
CLI Interface
Web API Server
Docker Integration
Result Validation
Technical Skills Matrix
Technologies
Business Value
- Automates manual workflows
- Improves consistency & quality
- Scalable architecture design
See Also
Stageflow
Stageflow is a full-stack portfolio application featuring a Next.js frontend and multiple Go microservices for automated website scanning and accessibility auditing with Axe. It targets developers showcasing advanced engineering skills in distributed systems.
AlchemizeCV
AlchemizeCV is a multi-service tool that processes GitHub repositories via CLI commands or web interface to produce structured analyses, resume bullets, and portfolio content using LLM providers.