git404hub

what is pwa-check fr?

pwa-today/pwa-check — explained in plain English

Analysis updated 2026-05-18

43JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

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.

vibe map

mindmap
  root((pwa-check))
    What it does
      Scans a web app URL
      Reports pass warn fail
      Exits nonzero on failure
    Checks
      Web app manifest
      Viewport tags
      iOS startup images
      Service worker handlers
    Tech stack
      JavaScript
      Node.js
      Workbox support
    Use cases
      CI pipeline gate
      Pre launch audit
      JSON reporting
    Audience
      Web developers
      PWA maintainers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run it in CI to fail a build automatically when a web app manifest or service worker is broken.

VIBE 2

Check a site before launch to confirm it will actually be installable on phones.

VIBE 3

Audit an existing PWA to find missing iOS startup images or manifest fields.

VIBE 4

Get a JSON report of PWA health to feed into another dashboard or tool.

what's the stack?

JavaScriptNode.jsWorkbox

how it stacks up fr

pwa-today/pwa-checkearthtojake/implicit.jsjavlonbek1233/amaliy-ish
Stars434343
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasyeasyeasy
Complexity2/53/52/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

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.

prompts (copy fr)

prompt 1
Show me how to run pwa-check against my local dev server URL and read the pass, warn, and fail output.
prompt 2
Help me add pwa-check to my CI pipeline so builds fail when a required manifest field is missing.
prompt 3
Explain the difference between the warn and fail results pwa-check gives me and which ones I should fix first.
prompt 4
Show me how to use the --json flag with pwa-check to save results for another script to parse.

Frequently asked questions

what is pwa-check fr?

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.

What language is pwa-check written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Workbox.

What license does pwa-check use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is pwa-check to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is pwa-check for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.