Skip to main content
Joshua Briley.
Back to blog
Design Systems 5 min read

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.

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 post is the thing itself. Run the inspection on a specimen below, 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.

Inspect the specimen

The exhibits below all shipped to production somewhere. They look fine at a glance, which is exactly the problem. 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 →

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 you walk away with

The Design System Audit reviews your library across all five dimensions in five business days. You receive a PDF report with every finding ranked by severity and a specific remediation for each, followed by a 60-minute debrief call to map what to fix first and why. No prep required on your end: send a Storybook URL, a Figma file, or a GitHub repo, whatever you already have. No specific format necessary.

The checklist I build against

The audit exists as a service, but those same five dimensions are not just something I sell. They are the standard my own work is held to: every system I ship gets reviewed against the same list before it goes out. If you want to run a quick self-assessment first, the design-system scorecard walks the same dimensions in about ten minutes.

Share

Written by

Joshua Briley

Design- and front-end-focused product engineer with 20 years in production UI. The interface is where I bring the most value (design-grade, accessible front-end), backed by capable full-stack development in Rails and TypeScript.

Keep reading / next