Skip to content

About

Chrome extension for auditing PWA installability with actionable fixes and one-click manifest & icon export.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PWA & Installability Inspector

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.

Features

  • Installability verdict — a single, clear answer on whether Chrome's beforeinstallprompt will 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_url is 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.

Install (development)

Requires Node ≥ 20.19 or ≥ 22.12 (Vite 8 / Rolldown).

npm install
npm run build

If the build fails with "Cannot find native binding" (a known npm optional-dependency bug with Rolldown), remove node_modules and package-lock.json and run npm install again.

Then load the unpacked extension:

  1. Open chrome://extensions
  2. Enable Developer mode
  3. Click Load unpacked and select the dist/ folder

For live development: npm run dev (HMR via @crxjs), then load dist/.

Privacy

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.

Development

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.

Contributing

See CONTRIBUTING.md. Contributions welcome — new analyzers, capability checks, and fixes especially.

License

MIT

About

Chrome extension for auditing PWA installability with actionable fixes and one-click manifest & icon export.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages