← Docs

Understanding your Health Score

Your Website Health Score is a single number from 0–100 that summarizes how production-ready your Bricks project is. It’s designed to be a score you can track over time and show to clients — not a vanity metric.

How it’s calculated

Every finding carries a weight based on its severity — a critical issue costs far more than a minor one. Those weights add up into a “problem points” total, which is mapped to a score on a diminishing-returns curve:

  • The first issues you fix move the score the most.
  • As the project gets cleaner, each remaining issue matters less.

This is deliberate: it rewards clearing the worst problems first, and it means a large site with a few minor issues still scores well.

The four category scores

Alongside the overall score, each audit gets its own score so you can see where the work is:

  • Design — color, spacing, and typography consistency
  • Classes — reusable styling instead of copy-paste
  • Responsive — how pages behave on every screen size
  • Performance — lean structure and right-sized media

How to improve it

  1. Start at the top of the findings list — issues are ranked by severity.
  2. Apply Smart Fixes where they’re offered (they snapshot and undo cleanly — see Applying Smart Fixes safely).
  3. Re-run the scan. The score updates immediately, so you can watch it climb.

A perfect 100 isn’t the goal on every project — a healthy, trending-up score is. Use it to decide when a build is ready to ship.