
BrowserUX PWA UI
A universal Web Component to display an installation and update interface for Progressive Web Apps (PWA), independent of any framework or bundler.
BrowserUX PWA UI provides a clear, consistent, and customizable user experience for installing and updating your PWA, while remaining lightweight, self-contained, and easy to integrate into any project, from simple HTML pages to modern JavaScript applications.
Download v1.0.0
pure HTML, React, Vue or Angular
See the CHANGELOG
npm install browserux-pwa-ui
Features
-
📲 Smart PWA Installation & Update UI
-
Automatic Install Prompt Handling
Detects and reacts to thebeforeinstallprompt
event to display a native-like install banner. -
Update Detection
Monitors the service worker viaregistration.waiting
and prompts the user when updates are available. -
Post-Install Feedback
Displays a confirmation banner after successful PWA installation. -
One-Click Update Flow
Automatically sends aSKIP_WAITING
message and reloads the app when the user accepts the update.
-
Automatic Install Prompt Handling
-
🔧 Developer Experience
-
Framework Agnostic
Works with any frontend stack: HTML, React, Vue, Angular, etc. -
Zero Dependency
Lightweight and bundler-free; compatible with CDN or modern JS toolchains. -
Optional Shadow DOM (
no-shadow
)
Use Shadow DOM by default or disable it to apply global styles.
-
Framework Agnostic
-
🌍 Accessibility & Internationalization
-
Multilingual Support
Auto-detects language or manually set it vialang
attribute. Includes built-in translations for EN, FR, ES, DE, JA, RU, PT, IT, and NL. -
Customizable Texts
Override all UI strings via simple HTML attributes.
-
Multilingual Support
-
🎨 Visual Customization
-
CSS Variables for Theming
Full styling control using custom properties like--bux-pwa-color-primary
. -
Icon Slot Customization
Replace built-in icons (close, loader, etc.) via named<slot>
elements.
-
CSS Variables for Theming