wyatts97/pwa-v2

Turn your flarum site into a progressive web app! (Flarum 2.x port)

v2.1.2 2026-05-13 16:45 UTC

Requires

• flarum/core: ^2.0.0-beta.0
• minishlink/web-push: ^7.0 || ^8.0 || ^9.0
• spomky-labs/base64url: ^2.0

Requires (Dev)

• flarum/phpstan: ^1.0

Suggests

• ext-gmp: This can improve push notification performance.

MIT

• Alexander Skvortsov
• wyatts97

• flarum

README

A Flarum extension. Progressive Web App support for Flarum 2.x with VAPID web-push notifications. Configure a PWA for your Flarum installation from your admin dashboard.

This is a fork of askvortsov/flarum-pwa updated for Flarum 2.x compatibility. Firebase/FCM support has been dropped; web-push (VAPID) is supported by all modern browsers including Chrome, Edge, Firefox, and Safari iOS 16.4+.

Features

• Installable as a standalone Progressive Web App
• Configurable web app manifest (short name, long name, theme color, background color, force portrait, window controls overlay)
• Per-size icon uploads (48 / 72 / 96 / 144 / 196 / 256 / 512 px)
• Service worker registration with offline fallback page
• VAPID web-push notifications wired into Flarum's notification system
• Native share button integration in discussion / post / user controls
• Per-user opt-in push preferences via Settings page

Installation

composer require wyatts97/pwa-v2

Updating

composer update wyatts97/pwa-v2
php flarum cache:clear

Configuration

Visit Admin → Extensions → Progressive Web App. Upload at least one icon (≥144 px) and set the short/long name. Generate VAPID keys via the "Reset VAPID keys" button. Users opt in to push notifications from their personal Settings page.

Credits

• Original extension: Alexander Skvortsov
• Original PWA work: Billy Wilcosky
• Flarum 2.x port: wyatts97

Links

• Source
• Original upstream