Lighthouse CI is a set of commands that make continuously running, asserting, saving, and retrieving Lighthouse results as easy as possible.
The node CLI (
npm install -g @lhci/cli) runs Lighthouse, asserts results, and uploads reports.
The node server (
npm install @lhci/server) stores results, compares reports, and displays historical results with a dashboard UI.
- Get a Lighthouse report alongside every PR.
- Prevent regressions in accessibility, SEO, offline support, and performance best practices.
- Track performance metrics and Lighthouse scores over time.
- Set and keep performance budgets on scripts and images.
- Run Lighthouse many times to reduce variance.
- Compare two versions of your site to find improvements and regressions of individual resources.
- Getting Started
- Troubleshooting / FAQs
- CLI Documentation
- Assertions Documentation
- Server Documentation
- Versioning Policy
language: node_js addons: chrome: stable before_install: - npm install -g @email@example.com script: - npm run build # build your site - lhci autorun # run lighthouse CI
Lighthouse CI GitHub Action - Automatically run Lighthouse CI on every PR with GitHub Actions, no infrastructure required.
Lighthouse CI Starter Example - A minimal example repo that you can use as a template when starting from scratch, offers a beginner-friendly quickstart guide using create-react-app.
A collection of unofficial blog posts, tutorials, and guides written by the community on using Lighthouse CI.
NOTE: This is not official documentation. You're encouraged to familiarize yourself with Lighthouse CI and read through Getting Started before continuing.
- Integerate Lighthouse CI for static website generator - An article on integrating Lighthouse CI with static website generators like Gatsby, Jekyll, etc.