GoogleChrome/lighthouse-ci
Lighthouse Ci
Lighthouse CI is a continuous integration tool designed to automate web audits and detect performance, accessibility, and SEO regressions between code commits. It functions as a web performance regression suite that enforces resource budgets and runs automated quality checks during the software development lifecycle.
The system distinguishes itself through the ability to block code merges if performance metrics fall below defined quality thresholds. It provides mechanisms for commit-to-commit comparison and cross-version site analysis to pinpoint specific resource improvements or regressions.
The project covers a broad range of observability and automation capabilities, including audit history tracking and performance trend monitoring. It utilizes headless browser orchestration to execute audits and supports the enforcement of maximum script and image sizes to prevent production bloat.
Features
- Performance Auditing - Automates the execution of web performance audits on every commit to detect regressions.
- CI/CD Regression Analyzers - Integrates performance regression analysis directly into CI pipelines to detect quality shifts.
- Automated Quality Workflows - Integrates performance, accessibility, and SEO checks into the development lifecycle as automated quality workflows.
- Performance Threshold Enforcement - Fails builds when performance metrics deviate from predefined quantitative thresholds.
- CI Integration Testing - Executes automated performance and accessibility test suites within CI/CD pipelines to prevent regressions.
- Quality Gates - Implements gating mechanisms that block code merges when performance budgets are violated.
- Continuous Web Auditing Tools - Provides an automated system for running performance, SEO, and accessibility checks during the development lifecycle.
- Regression Testing Suites - Provides a suite of automated tests that compare Lighthouse scores between commits to prevent performance degradation.
- Metric-Based Regression Testing - Compares current audit scores against predefined limits to determine if a build should fail.
- Headless Browser Orchestrators - Orchestrates headless browser instances to ensure consistent environments for capturing page metrics.
- Resource Budgeting - Fails builds when script or image sizes exceed defined resource budgets.
- Web Version Comparisons - Provides the ability to analyze two different versions of a site to pinpoint resource improvements or regressions.
- Commit Comparison Tools - Analyzes differences in performance metrics between a current commit and its ancestor.
- GitHub Actions - Provides native integration for executing performance audits via GitHub Actions on pull requests.
- Metric and Performance Monitors - Tracks performance metrics and scores over time to visualize the impact of changes on site quality.
- Audit Result Tracking - Stores and compares audit results across different commits to visualize performance shifts over time.
- Performance Trend Analysis - Provides interfaces for analyzing performance patterns and metric shifts across different versions of a site.
- Trend Analysis - Tracks web quality metrics over time to visualize the impact of changes on site speed and stability.
- Web Accessibility Compliance - Automatically scans web pages for accessibility and SEO violations to ensure compliance before production.
- Comparative Audit Analysis - Analyzes structured JSON audit data between commits to identify specific performance regressions and improvements.
- Performance Monitoring - Enforces performance budgets within CI/CD pipelines.
