# harlan-zw/unlighthouse

Run Google Lighthouse on your entire site.

Repository: https://github.com/harlan-zw/unlighthouse
Canonical: https://ross.abutalabs.com/products/unlighthouse
Homepage: https://unlighthouse.dev
Language: JavaScript
License: MIT
License Family: permissive
Topics: google-lighthouse, puppeteer, site-audit
Last push: 2026-08-14T15:40:01+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 90, longevity 100
- inputs: {"age_days": 1767, "days_push": 19, "days_rel": 65, "gap_med": 20, "n_releases_24m": 22}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4783, forks 164 (observed 2026-08-28T04:08:59.695968+00:00)

## What it is
Unlighthouse is an open-source CLI tool that runs Google Lighthouse audits on every page of a website, auto-discovering URLs via sitemaps, robots.txt, and internal links. It scans pages in parallel with a pool of Chrome workers and presents aggregated performance, accessibility, and SEO results in a real-time Vite-powered dashboard.

## Use cases
- run lighthouse on my entire site instead of one page at a time
- audit all pages of a website for performance and SEO issues
- check core web vitals across a whole site before launch
- enforce lighthouse score budgets in CI/CD pipelines
- find accessibility issues site-wide
- generate a site-wide lighthouse report as HTML or CSV
- monitor page speed regressions across a website

## When to choose
- you need Lighthouse scores for many or all pages of a site, not just one URL
- you want automatic URL discovery via sitemap and crawling with smart sampling
- you want a single command that fails CI when any page drops below a performance budget
- you want an interactive dashboard to explore, filter, and re-scan pages

## When to avoid
- you only need to audit a single page (the standard lighthouse CLI is simpler)
- you need deep synthetic monitoring or RUM over time rather than point-in-time audits
- your environment cannot run Chrome/Chromium (e.g., restricted CI runners without browser support)
- you rely on the Nuxt, Vite, or Webpack integrations, which are deprecated in favor of the CLI

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, monitoring, testing
- domain: web-development, performance, developer-tools
- platform: cli, cross-platform
- tags: lighthouse, site-audit, seo, accessibility, core-web-vitals, puppeteer, ci-cd, web-performance, nodejs

## Member repositories
- harlan-zw/unlighthouse (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:59.695968+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:18:43.247358+00:00, confidence not recorded.
  - readme: https://github.com/harlan-zw/unlighthouse (fetched 2026-08-28T04:08:59.695968+00:00, sha f27fa531c6c5)
  - homepage: https://unlighthouse.dev (fetched 2026-08-29T09:02:21.616225+00:00, sha c8e064984451)
  - site_page: https://unlighthouse.dev/guide/getting-started/installation (fetched 2026-08-29T09:02:21.625380+00:00, sha 7ab3861a8c3f)
  - site_page: https://unlighthouse.dev/guide/getting-started/how-it-works (fetched 2026-08-29T09:02:21.630803+00:00, sha 67546f9dd1ec)
  - registry_npm: https://registry.npmjs.org/unlighthouse (fetched 2026-08-29T09:02:21.639890+00:00, sha 930d6884a5b5)
  - site_page: https://unlighthouse.dev/integrations/cli (fetched 2026-08-29T09:02:21.628397+00:00, sha e185f7b7b414)
  - site_page: https://unlighthouse.dev/integrations/ci (fetched 2026-08-29T09:02:21.632790+00:00, sha 361a2c2b3045)
  - site_page: https://unlighthouse.dev/integrations/nuxt (fetched 2026-08-29T09:02:21.634698+00:00, sha 965875ffe635)
  - site_page: https://unlighthouse.dev/integrations/vite (fetched 2026-08-29T09:02:21.636331+00:00, sha 549c1bf3a9d9)
  - site_page: https://unlighthouse.dev/integrations/webpack (fetched 2026-08-29T09:02:21.638006+00:00, sha 3e5cb6e6c682)
- Data as of 2026-08-30T08:39:29.467469+00:00.