🐙 Accessibility Scanner v5.0.6: Anatomy of the Report

Each accessibility report is a comprehensive and interactive auditing workbench. Delivered as a single, fully editable, self-contained HTML file, it is engineered for deep analysis, human verification, and actionable remediation.

Note on Client Delivery & Security: When the report is downloaded and sent to a client (who typically opens it directly from their disk), it automatically enters a "Static Read-Only Mode". This complies with strict browser security policies (CORS) and ensures the client receives a fixed, tamper-resistant record of the audit without access to internal triage tools.

Important Note on Editing & Triage: The report features an "Enable Editing" mode. Any manual text changes, removals, or re-ordering made in this mode are permanently saved to the file when you click the "Save & Download HTML" button. Unlike standard tools, the v5.0.6 engine dynamically recalculates all charts, summary metrics, and narrative counts as you triage the data.

1. Auto-Generated Executive Summary & Analytics

The report opens with an intelligent strategic overview that adapts in real-time as you verify findings.

• Smart Narrative Summary: A natural-language overview identifying critical trends. This text is fully dynamic; if you approve a "Needs Review" item or hide a violation, the narrative and counts update automatically.
• Quantitative Severity Analysis: A live-updating breakdown of unique issue types categorised by severity (Critical, Serious, Moderate, and Minor).
• Visual Analytics Dashboards:
  • Top 5 Most Frequent Issues: Identifies recurring systemic violations to prioritise high-impact fixes.
  • Top 10 Problem Pages: Pinpoints specific URLs with the highest concentration of defects.

2. Interactive Review & Triage System

This section bridges the gap between automated scanning and human expertise, allowing for professional verification of results.

• "Needs Review" Queue: Issues that require human judgement (e.g. colour contrast on complex backgrounds) are isolated here.
• Approve & Categorise: Manually verify an item and click "Approve". The issue is instantly moved to its correct severity group, and all report metrics update.
• Verdict Filtering: Permanently "Remove" false positives or irrelevant items to ensure the final client report is 100% accurate.

3. Scan Execution & Scope Transparency

Complete technical transparency ensures the audit is reproducible and credible.

• Multi-Tier Error Logging: Distinct logs for System Errors (engine crashes), Crawl Errors (broken links), and Scan Errors (page-specific failures).
• Skipped Pages Log: A record of excluded URLs with explicit reasons (e.g. "Disallowed by robots.txt" or "Smart Crawl trap detection").
• PDF Tagging Analysis: Identifies linked PDF documents and flags those lacking internal accessibility structures.
• Passed Checks Verification: A collapsible list of every accessibility rule that was successfully tested and passed across the entire site.

4. Deep Analysis & Technical Evidence

Findings are organised to give developers everything they need to fix issues without leaving the report.

• Quick View Overview: A high-level accordion to see the "What" and "Where" of every issue. Includes a "Copy All URLs" button to instantly get a list of every page affected by a specific rule.
• Intelligent Remediation: The engine parses failure summaries to highlight a "Primary Recommendation" separately from alternative technical solutions.
• Parent DOM Context: Shows the HTML of the parent element, providing critical context for issues like nested interactive controls.
• Code Snippet Tools: Dedicated buttons to instantly copy the Fail HTML or the exact CSS Selector for use in dev tools.
• Internal Navigation: Each violation card includes "Previous" and "Next" buttons to allow for rapid keyboard-friendly triage.

5. Visual Evidence & Stamping

• High-Contrast Highlighting: Faliing elements are captured with a 4px red outline and white outer shadow.
• Diagnostic Stamping: Screenshots include a data footer with the Rule ID and HTML source, ensuring the image remains useful even if shared outside the report.
• Performance-Optimised Loading: For high-volume scans, the report only shows the first 25 instances of an issue, with a "Show More" toggle to maintain browser performance.

6. Workflow Integration & Memory Guard

• One-Click Ticket Generation: Generates Markdown/JSON tickets containing reproduction steps and code, ready for Jira or GitHub.
• Memory Guard (Sidecar Offloading): To prevent crashes on massive 1,000+ page scans, the system automatically offloads images to a _screenshots folder if the count exceeds 40.
• ZIP & Data Export: Download all screenshots as a single ZIP, or export the entire dataset as JSON or CSV.
• Report Integrity: A unique SHA-256 Hash is generated upon export to verify the report has not been tampered with.

Report Examples

💾 Download Example v5.0.6.0 Generated Reports

Dashboard Overview

Ticket Generation Modal

Stamped Screenshot Example