fof/pwa

Turn your flarum site into a progressive web app!

Maintainers

Package info

github.com/FriendsOfFlarum/pwa

Forum

Type:flarum-extension

pkg:composer/fof/pwa

Transparency log

Fund package maintenance!

Open Collective

Statistics

Installs: 367

Dependents: 0

Suggesters: 0

Stars: 2

Open Issues: 3

Security

Advisories: 0

Aikido package health analysis

1.x-dev 2026-08-12 11:48 UTC

Requires

Requires (Dev)

Suggests

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

Replaces

MIT 0ebdbd7dd0f246adf15012dfb294d5463f1ada12

  • Alexander Skvortsov <askvortsov.woop@flarum.org>
  • IanM

flarum

Published on Packagist.org on 2026-08-12 11:48 UTC

This package is auto-updated.

Last update: 2026-08-12 11:48:25 UTC

README

License Latest Stable Version

A Flarum extension. Progressive Web App support for Flarum. Configure a progressive web app for your flarum installation, all from your admin dashboard! Also now supports push notifications!

Please see resources like https://medium.com/pynk/what-is-a-pwa-and-how-to-install-add-to-home-screen-progressive-web-apps-e6e8087d9ad0 for more information on how to install this.

Credit

Thank you to Billy Wilcosky (https://github.com/zerosonesfun) for starting PWA support for Flarum. This extension uses his original ServiceWorker and offline html page code.

His original Discuss thread has been linked here: https://discuss.flarum.org/d/21487-pwa-progressive-web-app

TODO

  • Verify Support for subdirectory installations
  • Caching and expanded offline support
  • Support configuration of ALL webmanifest attributes, especially:
    • Related Applications
    • Categories
    • Language
  • Bugfixes and minor improvements

Installation

composer require fof/pwa

Note

Flarum 1.x depends on older versions of Monolog and psr/log. As a result, the latest compatible version of kreait/firebase-php depends on firebase/php-jwt, which Composer blocks due to the disputed advisory PKSA-y2cr-5h3j-g3ys.

To install this extension on Flarum 1.x, add a targeted exception for this advisory and ignore the PHP platform requirement:

composer config policy.advisories.ignore-id PKSA-y2cr-5h3j-g3ys
composer require fof/pwa --ignore-platform-req=php

The PHP platform requirement is ignored because newer kreait/firebase-php releases cannot be installed alongside Flarum 1.x dependencies, and the compatible releases do not declare support for PHP 8.5.

Updating

composer update fof/pwa

Links