Skip to content

GitHub Action for running @GoogleChromeLabs Lighthouse audits with all the bells and whistles πŸ”” Multiple audits, Slack notifications, and more!

License

Notifications You must be signed in to change notification settings

foo-software/lighthouse-check-action

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Repository files navigation

Lighthouse Check Action

Lighthouse

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! Check out the docs to get started with advanced configurations or refer to the quick start section below.

Features

This project differs 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]

jobs:
  lighthouse:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@master
    - name: Lighthouse
      uses: foo-software/lighthouse-check-action@master
      with:
        urls: 'https://www.foo.software,https://www.google.com'

Inputs and Advanced Configuration

For detailed documentation of all inputs and advanced configuration - visit the documentation!

Screenshots

Lighthouse Check GitHub action output 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

Credits

This package was brought to you by Foo - a website quality monitoring tool. Automatically test and monitor website performance, SEO and accessibility with Lighthouse. Analyze historical records of Lighthouse tests with automated monitoring. Report with confidence about SEO and performance improvements to stay on top of changes when they happen!