4,956
stars
184
forks
22
watchers
191
prs
239
issues
149
releases
README
!unlighthouse - Scan your entire website with Google Lighthouse.
Unlighthouse
[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![License][license-src]][license-href]
Unlighthouse scans your entire site using Google Lighthouse, with a modern UI, minimal config and smart sampling.
View Demo
Made possible by my Sponsor Program 💖 Follow me @harlan_zw 🐦 • Join Discord for help
Quick Setup
Run the following command:
bash
npx unlighthouse --site
or PNPM
pnpm dlx unlighthouse --site
[!TIP]
Using an AI agent? Get the unlighthouse Skill on skilld.dev/gh/harlan-zw/unlighthouse.
_Requirements: Node = 22.18.0._
Getting Started
Install instructions for all integrations can be found on the docs site.
Need a hand? Join the Discord for one-on-one help.
gitignore
Unlighthouse will save your reports in outputDir,
it's recommended you .gitignore these files.
shell
.unlighthouse
Debugging
If you run into any issues with Unlighthouse, the first step should be to re-run the scan with debugging enabled.
bash
NPM
npx unlighthouse --site unlighthouse.dev --debug
or PNPM
pnpm dlx unlighthouse --site unlighthouse.dev --debug
Docs
Integration instructions, Guides, API and config spec can be found on docs site.
Sponsors
License
Licensed under the MIT license.
[npm-version-src]: https://img.shields.io/npm/v/unlighthouse/latest.svg?style=flat&colorA=18181B&colorB=28CF8D
[npm-version-href]: https://npmjs.com/package/unlighthouse
[npm-downloads-src]: https://img.shields.io/npm/dm/unlighthouse.svg?style=flat&colorA=18181B&colorB=28CF8D
[npm-downloads-href]: https://npmjs.com/package/unlighthouse
[license-src]: https://img.shields.io/github/license/harlan-zw/unlighthouse.svg?style=flat&colorA=18181B&colorB=28CF8D
[license-href]: https://github.com/harlan-zw/unlighthouse/blob/main/LICENSE.mdTop issues
#433dependency-updates: run log for harlan-zw/unlighthouse9 comments · 2026-10-07#432ci-review: run log for harlan-zw/unlighthouse8 comments · 2026-10-07#212Catastrophic Score 8 comments · 2024-04-24#48Can I specify custom Lighthouse plugins in the config?6 comments · 2023-03-04#135Provide documentation to get to CSV export4 comments · 2023-06-16#25Make Report Deployment Easier4 comments · 2022-08-25#452How can Lighthouse help? :)3 comments · 2026-10-21#120Is it possible to run on the desktop and mobile version at the same time?3 comments · 2023-05-23
Discussions
#459Azure DevOps Extension0 comments · 2026-10-28#299Show results of multiple samples of a single URL?1 comments · 2026-01-30#276Date and show all pages0 comments · 2025-04-28#269Byte-weight reporting as NaN0 comments · 2025-03-18#238How to complete remove (purge) unlighthouse ?1 comments · 2024-09-13#222Speed Index on Performance Tab1 comments · 2024-06-03#206what does it mean 71% complete?0 comments · 2024-04-15#205all pages show as "loading" in the page title1 comments · 2024-04-15
Latest release
v0.19.1 v0.19.1 2026-10-03 🐞 Bug Fixes - ci: Stop stray "Canceled" stdout line after a successful scan - in https://github.com/harlan-zw/unlighthouse/issues/417 (3a7b3) View changes on GitHub