Skip to content

MosleyAutomationSystems/MAS-audit-toolkit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MAS Accessibility Audit Toolkit

A free, open-source desktop accessibility auditor built for real audits — not just quick scans.

Run a full WCAG 2.1 AA audit on any public URL in under 60 seconds. Get structured findings, severity grouping, and a built-in accessible GUI — with CVD simulation modes no free tool offers.


Why This Exists

Most free accessibility tools give you a number. This gives you a report.

WAVE and Lighthouse tell you something is wrong. The MAS Toolkit tells you what it is, why it matters, which WCAG criterion it maps to, and what to fix first — in a format you can hand to a client or a developer without translation.

And the auditor itself is fully accessible. Four themes. CVD simulation. Dyslexia presets. Font controls. Screen reader announcements. An accessibility auditor that doesn't pass its own audit isn't credible.


Quick Start

git clone https://github.com/MosleyAutomationSystems/MAS-audit-toolkit.git
cd MAS-audit-toolkit
pip install -r requirements.txt
python gui.py

Paste a URL. Click Run Audit. Done.


What It Checks (14 Modules — More Shipping Soon)

# Module WCAG Level
1 Alt Text Detection 1.1.1 A
2 Heading Structure 1.3.1 / 2.4.6 AA
3 Form Labels 1.3.1 A
4 Language Attribute 3.1.1 A
5 Tabindex Abuse 2.4.3 A
6 Empty Links 2.4.4 A
7 Empty Buttons 4.1.2 A
8 Autoplay Media 1.4.2 A
9 PDF Link Warning 2.4.4 A
10 Page Title 2.4.2 A
11 Duplicate IDs 4.1.1 A
12 Landmark Roles 2.4.1 A
13 Skip Navigation Link 2.4.1 A
14 Accessibility Patterns 2.4.4 A

62 additional modules are in the build queue. Platform Detection, Viewport Meta Check, Touch Target CSS Check, and more ship in upcoming releases.


GUI Features

Four Themes Dark · Light · High Contrast · CVD-Safe

CVD Simulation Modes Protanopia · Deuteranopia · Tritanopia · Monochrome

Test exactly what your color choices look like to users with color vision deficiencies — inside the auditor itself.

Accessibility Controls

  • Dyslexia font presets (Normal / Large / X-Large)
  • Font family and size controls (14–20pt), persisted across sessions
  • Word spacing and line height adjustments
  • Screen reader announcements on theme change, scan complete, and error states

Findings Output

  • Severity grouping: Critical → High → Moderate → Minor
  • Non-color prefix cues: [!] error · [OK] pass · [>] info
  • WCAG criterion mapped to every finding
  • Platform Restricted flag for CMS-locked sites (upcoming)

Who It's For

Solo accessibility practitioners who need a fast, structured audit workflow without a $200/month tool subscription.

Small agency developers who want to catch issues before handing off to clients.

Small business owners who want to understand their site's accessibility posture before hiring a developer.


What This Toolkit Is Not

This is a static HTML analysis tool. It catches approximately 30–40% of WCAG failures — the same range as any automated scanner. It does not replace manual review, screen reader testing, or user testing with disabled users. Automated tools are a starting point, not a certification.


Roadmap

  • Platform Detection (CMS identification + PLATFORM RESTRICTED flag)
  • Viewport Meta Check (user-scalable / maximum-scale flags)
  • Touch Target CSS Check (pointer:coarse 44×44px)
  • Color Contrast Checker (1.4.3 AA / 1.4.6 AAA)
  • Screen Reader Simulation (DOM tab-order traversal)
  • Report export: PDF / DOCX
  • Batch Mode (--batch urls.txt)
  • Web SaaS version (Q3–Q4)

See the full feature registry for the complete 100-feature build plan.


Built By

Damascus (Bear) Mosley — Lead Developer & Accessibility Specialist
Mosley Automation Systems · Grand Rapids, MI

All work governed by the Mosley Standard v2.0 — an internal engineering framework requiring accessibility as an operational requirement, not a design nicety.


License

MIT — free to use, fork, and build on. If you use it in client work, a mention is appreciated but not required.

About

WCAG 2.1 AA accessibility auditing tool — CLI and desktop GUI, built to the Mosley Standard

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages