Paste your manifest.json content into the Manifest input field. You can copy it from your project or export it from a live site via DevTools → Application → Manifest.
Optionally, paste your service worker JavaScript code into the Service Worker tab. If you don't have one, you can skip this step — the tool will still audit the manifest.
Click 'Audit PWA' or press ⌘↵ to run the analysis. The tool validates manifest fields, icon requirements, display modes, and service worker patterns.
Review the installability status, grade (A–F), and scored 0–100 result. Red errors block installability; orange warnings are recommended fixes.
Fix the issues flagged in your manifest and service worker code, then re-run the audit until you achieve installable status.
Manifest validator: checks required fields (name, short_name, start_url, display, icons), validates icon sizes (192x192, 512x512), purpose (maskable/any), and image formats (PNG, JPG, SVG, WebP).
Installability score: Grades A–F based on manifest completeness, icon requirements, display mode validity, and service worker presence. Flags show-stopping blockers that prevent Add to Home Screen.
Service worker code inspection: Detects install/activate/fetch event listeners, caching patterns (Cache First, Network First, Stale-While-Revalidate, Network Only), and flags anti-patterns like caching everything without expiry.
Offline support detection: Checks for fetch handlers that serve cached responses, navigation fallbacks, and offline pages. Flags missing offline capabilities.
Cache versioning audit: Ensures cache names include version identifiers (e.g., 'static-v1') and that activate handlers clean up old caches. Prevents stale asset leaks.
Caching strategy recommendations: Identifies which strategy your service worker uses and suggests improvements — e.g., use Network First for API calls, Cache First for static assets.
Display mode validation: Verifies display values (standalone, fullscreen, minimal-ui, browser) and warns about suboptimal choices for your use case.
Icon completeness checker: Ensures both 192x192 and 512x512 icons exist, correct purpose attributes are set, and file formats are supported. Missing 512x512 blocks installability.
Security & privacy: All analysis runs in your browser. No manifest or service worker code is ever sent to external servers — your IP and code stay private.
AI-powered explanations: Select any issue to get an AI-generated explanation of why it matters and exact code snippets to fix it (requires AI provider configured).
Exportable JSON reports: Copy the full audit result as formatted JSON (⌘⇧C) for sharing with your team, CI/CD integration, or tracking PWA progress over time.
Example manifests: Built-in examples show minimal valid PWA, common install blockers, and a full-featured manifest with service worker — great for learning.
