Skip to main content


A GitHub Action for running Lighthouse audits automatically in CI workflows. Lighthouse Check Action provides simple configuration and a long list of features for advanced customization including Slack notifications, AWS S3 HTML report uploads, and more!


This project differes from others with its ease of use for simple cases and numerous features for advanced needs.

  • โœจ Lighthouse audit multiple URLs or just one.
  • ๐Ÿ’ฌ PR comments of audit scores.
  • ๐ŸŽ‰ Save HTML reports locally.
  • ๐Ÿ’– Upload HTML reports as artifacts.
  • ๐Ÿ™Œ Upload HTML reports to AWS S3.
  • ๐Ÿ”ฅ Fail a workflow when minimum scores aren't met.
  • ๐Ÿ›Ž๏ธ Slack notifications with Git info (author, branch, PR, etc).
  • ๐Ÿ’Ž Easily save a record of all your audits via Foo's free service.
  • ๐Ÿค— Detailed documentation!

Quick Start#

name: Lighthouse
on: [pull_request]
runs-on: ubuntu-latest
- uses: actions/checkout@master
- name: Lighthouse
uses: foo-software/lighthouse-check-action@master
urls: ','


Lighthouse Check GitHub action output
Lighthouse Check GitHub action save artifacts
Save HTML Reports as Artifacts
Lighthouse Check GitHub action HTML report
HTML Reports
Lighthouse Check PR comments
PR Comments
Lighthouse Check GitHub action Slack notification
Slack Notifications
Lighthouse Check GitHub action fail if scores don't meet minimum requirement on a PR
Fail Workflow when Minimum Scores Aren't Met