explaingit

harlan-zw/unlighthouse

★ 4,561JavaScriptAudience · developerComplexity · 1/5LicenseSetup · easy

TLDR

Unlighthouse scans every page of your website with Google Lighthouse in one command, checking speed, accessibility, SEO, and best practices across the whole site instead of one page at a time.

Mindmap

mindmap
  root((unlighthouse))
    What it does
      Site-wide scanning
      Lighthouse automation
      Visual results
    What it checks
      Speed
      Accessibility
      SEO
      Best practices
    Usage
      Single command
      Smart sampling
      Local reports
    Requirements
      Node.js 20+
      No config needed
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Run a full site-wide SEO and performance audit in one command without manually checking each page

USE CASE 2

Check accessibility scores across every page of a client website before launch

USE CASE 3

Find slow or poorly optimized pages across a large site using Lighthouse's standard checks

Tech stack

JavaScriptNode.js

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose including commercial use, as long as you keep the copyright notice.

In plain English

Unlighthouse is a tool that runs Google Lighthouse across every page of a website in one go. Google Lighthouse is a free Google tool that checks web pages for speed, accessibility, search engine optimization, and general best practices. Normally you run it on one page at a time, either through Chrome's developer tools or via a command line. Unlighthouse automates the process for an entire site and presents the results in a visual interface. You run it from the command line with a single command: point it at your site's URL and it does the rest. It uses smart sampling to scan pages without needing to manually list every URL, and it saves reports to a local folder on your machine. The README recommends adding that folder to your .gitignore file so the reports do not end up in your code repository. The tool requires Node.js version 20 or later. No configuration is required to get started. A debug mode is available if the scan runs into problems. Integration instructions for using Unlighthouse as part of a larger setup, along with a full configuration reference, live on the project's documentation site rather than in the README itself. The README is brief and does not describe the specifics of the results interface or what metrics are displayed beyond the reference to Google Lighthouse's standard checks. The project is licensed under the MIT license and is community-funded through a sponsor program.

Copy-paste prompts

Prompt 1
Show me the command to run Unlighthouse on my website to scan all pages for speed, SEO, and accessibility issues
Prompt 2
How do I add the Unlighthouse output folder to my .gitignore to keep reports out of my code repository?
Prompt 3
How do I enable debug mode in Unlighthouse when a scan is failing to complete properly?
Prompt 4
What Node.js version does Unlighthouse require and how do I install it with a single command?
Open on GitHub → Explain another repo

← harlan-zw on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.