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