← Back to Docs
Recipe

Lighthouse Audit

Run automated performance, accessibility, and SEO audits against your deployed pages on every push.

Trigger

Fires on push to any branch. Targets the production deployment URL or a preview URL derived from the branch name.

Steps

  1. Wait for the Vercel deployment to complete.
  2. Run Lighthouse CI against the live URL.
  3. Assert minimum scores: Performance ≥ 90, Accessibility ≥ 95, SEO ≥ 90.
  4. Upload the HTML report as a build artifact.

Output

A Lighthouse report is attached to the workflow run. If any threshold is breached the step fails, blocking the merge until scores are restored.

Tip: Pin Lighthouse to a specific version in CI to prevent score drift from upstream algorithm changes.