Skip to main content
JoshuaBriley.
Tools / Inspector

What an audit actually finds

Every finding ranked by severity, each paired with a specific fix. This is a working sample of the real audit deliverable: inspect a specimen, then read the findings the way you would read the report.

  • Two specimens
  • Ranked by severity
  • A fix attached to each

The exhibits all shipped to production somewhere. They look fine at a glance, which is exactly the problem. Pick a screen, toggle the issues on, and the inconsistencies surface: the small drift that quietly costs a team sprint velocity, ranked the way a real audit pass would rank it.

Take a look

What an audit actually finds.

Pick a screen. Toggle “show issues”. The dashed boxes are the inconsistencies a quick pass would flag: the kind that quietly cost your team sprint velocity.

your-app.com/pricing

Starter

$19/mo

  • Up to 3 projects
  • Email support
  • Basic analytics

Business

$99/mo

  • Unlimited projects
  • Dedicated CSM
  • SSO & audit logs

This is the kind of review I run on a system before deciding what to fix first. Get in touch →

Every audit ends in a report. Not a vibe, not a list of complaints: every finding ranked by severity, each one paired with a specific, actionable fix. Describing that deliverable in the abstract never lands, so this page is the thing itself. Run the inspection on a specimen, then read the findings the way you would read the real report.

The point of an audit is not to tell you your system is messy. You already suspect that. The point is to make the mess legible: to separate the issue that breaks accessibility from the issue that is merely untidy, and to attach a concrete remediation to each so the work is obvious once you sit down to do it.

Notice that the findings sort themselves. High severity is the stuff that breaks accessibility or erodes trust. Medium is drift that compounds over time. Low is polish and consistency. Reading the report is less about counting problems and more about knowing which three to fix first.

What a pass produces

A review walks the library across all five dimensions and comes back as one document: every finding ranked by severity, each with a specific remediation attached. The input can be a Storybook URL, a Figma file, or a repository, whatever already exists. Nothing needs to be prepared first, and the format does not matter, because the point is to read the system as it actually is rather than as it was meant to look.

The checklist I build against

Those five dimensions are not a framework I hand to other people. They are the standard my own work is held to: every system I ship gets read against the same list before it goes out, which is why the findings here are worded the way they are. If you want to run a quick self-assessment first, the design-system scorecard walks the same dimensions in about ten minutes.

Share

Built the way I build production work.

Accessible controls, live state, no framework underneath, and the same tokens as the rest of this site. It should hold up to being inspected as production work. The case studies show the same standard at full product scale.