DEV Community

Loc Nguyen
Loc Nguyen

Posted on Edited on

Automating ISO 14289-1 (PDF/UA-1) & ADA Title II PDF Gateways in GitHub Actions + Local Python Batch Pipelines

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'
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

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

Top comments (0)