https://github.com/harlan-zw/unlighthouse
Run Google Lighthouse on your entire site.
https://github.com/harlan-zw/unlighthouse
google-lighthouse puppeteer site-audit
Last synced: 2 months ago
JSON representation
Run Google Lighthouse on your entire site.
- Host: GitHub
- URL: https://github.com/harlan-zw/unlighthouse
- Owner: harlan-zw
- License: mit
- Created: 2021-10-31T07:14:30.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-04-13T08:41:48.000Z (2 months ago)
- Last Synced: 2026-04-13T10:36:17.015Z (2 months ago)
- Topics: google-lighthouse, puppeteer, site-audit
- Language: JavaScript
- Homepage: https://unlighthouse.dev
- Size: 25.2 MB
- Stars: 4,506
- Watchers: 25
- Forks: 145
- Open Issues: 31
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
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.
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]
> Generate an Agent Skill for this package using [skilld](https://github.com/harlan-zw/skilld):
> ```bash
> npx skilld add unlighthouse
> ```
_Requirements: Node >= 20.x._
## Getting Started
Install instructions for all integrations can be found on the [docs](https://unlighthouse.dev/) site.
Need a hand? Join the [Discord](https://discord.gg/275MBUBvgP) 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](https://unlighthouse.dev/) site.
## Sponsors
## License
Licensed under the [MIT license](https://github.com/harlan-zw/unlighthouse/blob/main/LICENSE.md).
[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