harlan-zw /unlighthouse

Run Google Lighthouse on your entire site.

★ 4,956⑂ 184👁 22⑃ 191● 239▤ 149
JavaScriptMITCreated 2021-10-31unlighthouse.dev
Download: v0.19.1v0.19.1 ↓0.19.12026-10-03
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.md

Top issues

Discussions

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

Snapshot: 2026-11-17T21:58:29Z · Data license Apache-2.0 · JSON