Unlighthouse

Unlighthouse scans your entire site using Google Lighthouse,
with a modern UI, minimal config and smart sampling.

_{Made possible by my Sponsor Program 💖
Follow me @harlan_zw 🐦 • Join Discord for help}

Quick Setup

Run the following command:

npx unlighthouse --site <your-site>
# or PNPM
pnpm dlx unlighthouse --site <your-site>

Tip

Using an AI agent? Get the unlighthouse Skill on skilld.dev/gh/harlan-zw/unlighthouse.

Requirements: Node >= 22.18.0.

Install instructions for all integrations can be found on the docs site.

Need a hand? Join the Discord for one-on-one help.

Unlighthouse will save your reports in outputDir, it's recommended you .gitignore these files.

.unlighthouse

If you run into any issues with Unlighthouse, the first step should be to re-run the scan with debugging enabled.

# NPM
npx unlighthouse --site unlighthouse.dev --debug
# or PNPM
pnpm dlx unlighthouse --site unlighthouse.dev --debug

Integration instructions, Guides, API and config spec can be found on docs site.

Licensed under the MIT license.