Performance

Lighthouse-based performance auditing with Web Vitals thresholds

How it Works

The performance pillar uses Lighthouse with chrome-launcher to audit your page. It extracts the overall performance score and individual Web Vitals metrics, comparing each against your configured thresholds.

Metrics Checked

Metric	Default Limit	Description
LCP	2500ms	Largest Contentful Paint
CLS	0.1	Cumulative Layout Shift
INP	200ms	Interaction to Next Paint
TTFB	800ms	Time to First Byte
FCP	1800ms	First Contentful Paint
Score	80	Overall Lighthouse performance score

Configuration

json

{
  "performance": {
    "minScore": 85,
    "lcp": 2500,
    "cls": 0.1,
    "inp": 200,
    "ttfb": 800,
    "fcp": 1800
  }
}

Violation Examples

bash

✖ PERFORMANCE  Score: 72
    [critical] Performance score 72 is below minimum 80
      → Run Lighthouse locally to identify the biggest opportunities.
    [serious] LCP is 3200ms (max: 2500ms)
      → Optimize the largest image/video. Use <link rel="preload"> for critical resources.

Programmatic API Accessibility