# ICJIA File Accessibility Audit

> Automated PDF accessibility scoring tool built by Illinois Criminal Justice Information Authority.

This web application analyzes PDF documents for accessibility compliance and produces a detailed audit report scored against WCAG 2.1 Level AA and ADA Title II requirements.

## What it does

- Accepts a PDF file upload (up to 50 MB)
- Analyzes the document across 9 accessibility categories
- Returns an overall score (0-100), letter grade (A-F), and per-category findings
- Provides remediation guidance with WCAG success criteria references
- Exports reports in Word (.docx), HTML, Markdown, and JSON formats
- JSON export includes machine-readable WCAG mappings, prioritized remediation plans, and LLM-ready context

## Scoring categories (weighted)

1. Text Extractability (20%) - WCAG 1.3.1, 1.4.5
2. Document Title & Language (15%) - WCAG 2.4.2, 3.1.1
3. Heading Structure (15%) - WCAG 1.3.1, 2.4.6
4. Alt Text on Images (15%) - WCAG 1.1.1
5. Bookmarks / Navigation (10%) - WCAG 2.4.5
6. Table Markup (10%) - WCAG 1.3.1
7. Link & URL Quality (5%) - WCAG 2.4.4
8. Form Accessibility (5%) - WCAG 1.3.1, 4.1.2
9. Reading Order (5%) - WCAG 1.3.2

## Grade scale

- A: 90-100 (Excellent)
- B: 80-89 (Good)
- C: 70-79 (Needs Improvement)
- D: 60-69 (Poor)
- F: 0-59 (Failing)

## Standards alignment

- WCAG 2.1 Level AA
- ADA Title II (effective April 2026)
- Section 508
- PDF/UA (ISO 14289-1)

## API

The application exposes a REST API:

- POST /api/analyze - Upload a PDF for analysis (multipart/form-data, field: "file")
- POST /api/reports - Create a shareable report link (JSON body: { report })
- GET /api/reports/:id - Retrieve a shared report by ID
- GET /api/health - Health check endpoint

## Links

- Website: https://audit.icjia.app
- Source: https://github.com/ICJIA/file-accessibility-audit
- FAQs: https://accessibility.icjia.app
- Organization: https://icjia.illinois.gov

## Optional: llms-full.txt

For complete documentation including the scoring rubric, category explanations, remediation guidance, and JSON export schema, see /llms-full.txt