@molecule/app-pwa-default

Auto-generated, AI-first package reference for the molecule.dev ecosystem. It is written to be read by coding agents as much as by people, and is generated from this package's source — edit src/index.ts JSDoc, not this file.

@molecule/app-pwa-default — drop-in PWA service worker registration with update banner, multi-tab coordination, and i18n-localized labels.

Apps' src/pwa.ts shrinks from 147 lines to a 1-line re-export.

Quick Start

// src/pwa.ts is a 1-line re-export:
//   export { registerPWA } from '@molecule/app-pwa-default'
// then call it once at app startup (e.g. in main.tsx):
import { registerPWA } from '@molecule/app-pwa-default'

registerPWA()

Type

feature

Installation

npm install @molecule/app-pwa-default @molecule/app-i18n @molecule/app-logger vite-plugin-pwa

API

Functions

registerPWA()

Registers the service worker with full PWA lifecycle management:

• Periodic update checks (every 5 minutes)
• Styled update banner with Update button
• Multi-tab coordination (all tabs reload when new SW activates)
• Window focus notification to SW
• Error recovery (unregister SW + reload on fatal errors)

function registerPWA(): void

Injection Notes

Requirements

Peer dependencies:

• @molecule/app-i18n ^1.0.1
• @molecule/app-logger ^1.0.1
• vite-plugin-pwa ^0.20.0 || ^1.0.0

Runtime Dependencies

• @molecule/app-i18n
• @molecule/app-logger
• vite-plugin-pwa

Vite-only: imports the virtual:pwa-register module that vite-plugin-pwa generates, so the VitePWA() plugin MUST be configured in vite.config.ts (molecule scaffolds do this) — without it the import does not resolve and the build fails. Not usable under other bundlers. Framework-agnostic at runtime: the update banner is plain DOM (no React), themed via the app's --color-surface/--color-border/--color-foreground/--color-success CSS variables. Banner labels use the pwa.update, pwa.updateAvailable, and pwa.updating keys from @molecule/app-locales-common — load that bond's translations before the banner can appear, or the raw keys are shown. Call registerPWA() exactly once at app startup; it is a no-op during SSR.