With the U.S. Department of Justice ADA Title II (28 CFR Part 35) web and mobile content rule active since April 24, 2026 for public entities serving 50,000+ residents (and April 26, 2027 for smaller municipalities and special districts), public-sector engineering teams and digital agencies face a recurring regression problem: even after remediating a PDF library to WCAG 2.1 Level AA and ISO 14289-1 (PDF/UA-1), a single untagged agenda, fee schedule, or scanned PDF merged into a CMS or static repo re-introduces compliance failures.
Here is how to combine a $0 open-source GitHub Action PR gate with a local zero-cloud Python batch pipeline so inaccessible PDFs are caught automatically before deployment.
Accessibility Engineering Scope Notice: This guide covers automated ISO 14289-1:2014 (PDF/UA-1), Revised Section 508, and WCAG 2.1 AA machine-testing pipelines—it does not constitute legal advice. Always pair machine validation (
veraPDF/PAC) with assistive-technology reading-order verification (NVDA/JAWS/VoiceOver).
1. Add a 6-Line PDF/UA Gate to GitHub Actions ($0)
Drop .github/workflows/pdfua-gate.yml into any municipal portal, university site, or documentation repository using our open-source composite action (hadesloc/pdfua-ada-checker@v1):
name: PDF/UA-1 & ADA Title II Compliance Gate
on:
pull_request:
paths:
- '**/*.pdf'
workflow_dispatch:
jobs:
pdfua-check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Validate PDFs against ISO 14289-1 (PDF/UA-1)
uses: hadesloc/pdfua-ada-checker@v1
with:
pdf-path: 'public/documents'
fail-on-violations: 'true'
max-files: '20'
Every pull request receives a Markdown $GITHUB_STEP_SUMMARY table listing each scanned PDF, failed ISO 14289-1 clause counts, and plain-English remediation notes—and fails the build (exit 1) when fail-on-violations: 'true' detects untagged streams, missing /Lang, unembedded font subsets, or unlabeled /AcroForm fields.
2. Local Pre-Commit Screening Without Uploading Confidential Drafts
When working with embargoed budgets or internal drafts prior to publication, run a local Python 3 stdlib pre-check across your folder before committing:
python pdfua_quick_audit.py ./public/documents --json pdfua-precheck.json --fail-on-issues
The local auditor inspects binary /StructTreeRoot, /MarkInfo << /Marked true >>, XMP pdfuaid:part, /Lang, /DisplayDocTitle, interactive /AcroForm /TU tooltips, /Tabs /S focus order, and un-OCRed image-only pages in milliseconds with 0 network calls.
3. Free Validators, Open-Source Releases & Self-Serve Studio Bundles
-
Open-Source GitHub Action Repository (
Apache-2.0): https://github.com/hadesloc/pdfua-ada-checker -
Free Online
veraPDF 1.30.3Browser Checker (0Files Retained): https://hadesloc.github.io/pdfua-partner-desk/ -
Free Open-Source Compliance Starter CLI Kit (
$0+PWYW): https://pdfuapartnerdesk.gumroad.com/l/compliance-starter-kit -
PDF Accessibility Studio Solo (
$9.50w/EARLY50— unlimited local PDFs, auto-tagging, font repair, RapidOCR3 Tr, local Web UI, CI gate &OPERATOR-QA.md): https://pdfuapartnerdesk.gumroad.com/l/pdfua-express-5-pages/EARLY50?wanted=true -
PDF Accessibility Studio Agency (
$32.50w/EARLY50) & Commercial ($97.50w/EARLY50) Batch Suites: Studio Agency ($32.50) · Studio Commercial ($97.50) - Copy-Paste GitHub Actions Gate Workflow (Public GitHub Gist): pdfua_github_action_and_batch_gate.yml
-
GitHub Releases (
v1.1.0Action +v1.0.0CLI Starter ZIP): pdfua-ada-checkerv1.1.0· pdfua-partner-deskv1.0.0
Top comments (0)