In-App Report Viewer

The Reports tab in Vesper Audit lets you browse scan results directly inside the app - no PDF required, no external files to open. After every scan, a complete results file is written automatically and the viewer is ready to load it.

Opening the viewer after a scan

When a scan completes, a result card appears in the Audit panel. Click Open in Viewer on that card to switch to the Reports tab with your results already loaded.

Opening a previous scan

To load results from an earlier scan, go to the Reports tab and click Open Report... in the toolbar. Select any .json results file from your output folder. Every scan automatically writes one of these files, so your full audit history is available as long as you keep the output files.

The sidebar

The left sidebar lists every page that was scanned, sorted by violation count from highest to lowest. Pages with no violations appear at the bottom of the list with a clean indicator. Each page row shows the page path and a count of violations found.

Click any page in the sidebar to load its violation detail in the main panel.

Violation cards

The main panel shows all violations found on the selected page. Each violation card includes:

• Rule name and description - a plain-language explanation of what was detected
• Impact badge - Critical, Serious, Moderate, or Minor
• WCAG reference - the success criterion the violation maps to, linked to the W3C Understanding page
• Affected elements - the HTML selector and element snippet for each instance found on the page
• Guide link - where a Vesper Guide exists for the rule, a link to the guide appears at the bottom of the card

Opening pages in your browser

Below the page path in the main panel header, the full URL of the page is shown as a clickable link. Click it to open that page in your default browser so you can locate and fix the violations directly.

Filtered reports

If a scan was run with an active Report Filter, an amber notice bar appears directly below the viewer toolbar when that report is loaded. The notice names the categories that were active and makes clear this is not a full accessibility audit.

The notice is absent when the report was generated with All rules. Reports generated with a filter and reports generated without one can always be distinguished at a glance.

Results JSON files

Every scan writes a .json results file to your output folder automatically - this cannot be disabled. The filename includes the domain and timestamp:

example-com--2026-04-05-09-14-22.json

These files are the viewer's data source. Keep them if you want to be able to review or compare past scans. See Output Formats for more detail on what the file contains.