Run it in CI to fail a build automatically when a web app manifest or service worker is broken.
Check a site before launch to confirm it will actually be installable on phones.
Audit an existing PWA to find missing iOS startup images or manifest fields.
Get a JSON report of PWA health to feed into another dashboard or tool.
| pwa-today/pwa-check | earthtojake/implicit.js | javlonbek1233/amaliy-ish | |
|---|---|---|---|
| Stars | 43 | 43 | 43 |
| Language | JavaScript | JavaScript | JavaScript |
| Setup difficulty | easy | easy | easy |
| Complexity | 2/5 | 3/5 | 2/5 |
| Audience | developer | developer | vibe coder |
Figures from each repo's GitHub metadata at analysis time.
pwa-check is a command line tool that scans a web app and tells you whether it is actually ready to work as a Progressive Web App, meaning it can be installed on a phone or desktop, and still function when there is no internet connection. Instead of guessing, you point it at a URL and it inspects the page's HTML, its web app manifest file, its scripts, and its service worker to find the pieces that are missing or broken. The tool looks at the manifest for settings like scope, display mode, start URL, description, icons, and screenshots, and it also checks whether the icons and other linked files can actually be reached, since a broken image link makes an app look unfinished. It checks the page's viewport settings, which control how the app scales on different screen sizes, and it looks for iOS specific startup images so the first launch does not feel incomplete on Apple devices. It also examines the service worker, a background script that lets the app cache files and respond to events like push notifications, to confirm it handles installation, activation, network requests, and notifications correctly. It understands service workers built with the popular Workbox library too. Every check comes back as pass, warn, or fail, and the tool exits with an error code if anything fails, so it can be wired into an automated testing pipeline to catch problems before they reach users. You can also choose to treat warnings as failures, ignore specific warning codes you do not care about, get the results as JSON for other tools to read, or set a timeout for how long each check waits on a slow server. It can be installed as a package and run with a single command, or run directly from the source code without installing it globally. The project is released under the ISC license, which is a permissive license similar to MIT that allows free use with attribution.
A command line checker that scans a web app and reports what is missing before it can work fully as an installable, offline-capable app.
Mainly JavaScript. The stack also includes JavaScript, Node.js, Workbox.
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.