A Chrome extension that analyzes any site against PWA standards and gives actionable recommendations — not just PASS/FAIL. Manifest, Service Worker, icons, offline behavior, and Advanced Capabilities (Fugu) APIs, in one click, with one-click export and generators to fix what's missing.
Lighthouse trimmed its PWA audit and DevTools scatters this information across panels. This extension focuses narrowly but deeply on PWA installability: an instant verdict, concrete fixes, and generators.
- Installability verdict — a single, clear answer on whether Chrome's
beforeinstallpromptwill fire, with each requirement checked off. - Manifest audit — per-field validation (name, start_url, display, icons, scope, theme/background color, …) with fix recommendations.
- Icon audit — checks for 192/512, maskable coverage, verifies icons load (no 404s) and that declared sizes match the real image.
- Service worker — registration, scope, state, and page control.
- Offline readiness — checks whether a service worker controls the page and
whether
start_urlis present in Cache Storage (an estimate; no special permissions required). - Fugu / Advanced Capabilities — detects which capability APIs are available.
- Generators — export the current manifest, generate a corrected manifest, build a full icon set (incl. maskable) from a single image, and copy ready snippets.
Requires Node ≥ 20.19 or ≥ 22.12 (Vite 8 / Rolldown).
npm install
npm run buildIf the build fails with "Cannot find native binding" (a known npm optional-dependency bug with Rolldown), remove
node_modulesandpackage-lock.jsonand runnpm installagain.
Then load the unpacked extension:
- Open
chrome://extensions - Enable Developer mode
- Click Load unpacked and select the
dist/folder
For live development: npm run dev (HMR via @crxjs), then load dist/.
This extension runs entirely locally. It reads the manifest, service worker state, icons, and capability flags of the page you're inspecting to produce the report — none of that ever leaves your browser. There is no telemetry, no analytics, and no network calls other than fetching the inspected page's own manifest, icons, and scripts.
npm run test # unit tests (Vitest) for the analyzers
npm run lint # type-check
npm run build # production build to dist/Architecture:
src/collect/collector.ts— injected into the page's MAIN world to gather raw data.src/analyzers/*— pure functions: raw data in, findings out (unit-tested).src/background/service-worker.ts— orchestrates injection, audit, storage.src/ui/popup/src/ui/report— compact verdict + full report with generators.
See CONTRIBUTING.md. Contributions welcome — new analyzers, capability checks, and fixes especially.