Progressive Web App Development

Knowledge base for building, auditing, and shipping Progressive Web Apps in 2025-2026. Covers manifest, service workers, Web Push, install flows, storage, Project Fugu capabilities, platform constraints, performance (Core Web Vitals), security, and distribution to Google Play, Microsoft Store, App Store (via Capacitor), and Meta Quest.

When to use this skill

Use this skill whenever the active task involves any of:

• A manifest.webmanifest or manifest.json, manifest members, icons, splash screens, iOS meta tags.
• A service worker file, registration, caching strategy, update flow, Workbox 7, Serwist.
• Web Push: VAPID keys, subscription, server-side delivery, Declarative Web Push.
• PWA install flow on Chromium (beforeinstallprompt), iOS (manual), or Window Controls Overlay on desktop.
• Background execution: Background Sync, Periodic Background Sync, Background Fetch, Screen Wake Lock.
• Storage: IndexedDB, OPFS, quotas, navigator.storage.persist().
• Project Fugu APIs: File System Access, Web Share, Web Bluetooth / USB / HID / Serial / NFC, WebAuthn, etc.
• Performance for PWAs: Core Web Vitals 2025, INP < 200ms, app shell, code splitting.
• Security headers for PWAs: HTTPS, CSP tuned for SW, COOP / COEP for SharedArrayBuffer.
• Distribution: Bubblewrap to Google Play (TWA + assetlinks.json), PWA Builder to Microsoft Store (MSIX), Capacitor to App Store, PWA Builder to Meta Quest.
• Framework integration: Vite (vite-plugin-pwa), Next.js (@serwist/next), Angular (ng add @angular/pwa), Nuxt (@vite-pwa/nuxt).