himanshu-dixit/lighthouse-ci-action

Lighthouse CI Action is a tool that automatically checks the speed and quality of your web pages every time you push code to GitHub. Instead of manually running performance tests, you list the URLs you care about, and this action runs Google's Lighthouse audit against them on each push or pull request. If a page loads too slowly or exceeds a performance budget you set, the check fails right in your GitHub workflow. You set it up by adding a small configuration file to your repository that lists the URLs to test. You can also define a performance budget, such as limiting total page weight to 200 kilobytes. When the action runs, it loads each URL in a headless browser, measures things like load time and page size, and compares the results against your budget or custom assertions. Results can be saved as downloadable artifacts or uploaded to a temporary public link or a private server for your team to review. This is useful for teams shipping web apps who want to prevent performance regressions before they reach users. For example, if a developer adds a heavy image library that bloats the page, the action catches it and flags the build as failing. It works with live URLs, static site builds that haven't been deployed yet, and preview deployments from platforms like Netlify. The project is built as a GitHub Action, meaning it plugs directly into GitHub's automation system with minimal setup, initializing in under a second. It was built in collaboration with the Lighthouse team and Treo, a web performance monitoring company. One notable tradeoff: single-run performance tests can be flaky, so the tool supports multiple runs per URL for more reliable assertions.