Open source · Web & UX

PWA Manifest Auditor

Validate manifest fields, icons, display modes and offline shell expectations.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

TOOLID=pwa-manifest-auditor. Validate a local web manifest against a separately exported built-site inventory. Check start URL, scope, icon references and metadata, and separately report what the export says about an offline shell. No browser is driven, no host is resolved, no service worker is run, and no site is changed. Node.js 22+; zero dependencies.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+; inspect the source before using it on your own files.

Run the checked-in example

node bin/pwa-manifest-auditor.mjs --root examples/passing --manifest manifest.webmanifest --site site.json
node bin/pwa-manifest-auditor.mjs --root examples/failing --manifest manifest.webmanifest --site site.json
npm run check

Read the result

The first example exits 0/pass; the second exits 1/fail for a start URL outside scope and an absent icon. --help lists options. JSON is written only to stdout. Input paths are relative to --root; a symlink resolving outside its real directory is refused. There is no output-file option, so input documents cannot be overwritten.

Where this check stops

This local walkthrough does not establish the state of a live production system or replace the limits documented in the repository.

Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.

Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.