You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Filip Š 36f6cc3feb
Update extension dependencies
5 days ago
.github Update PortableApps Installer to 3.7.5 1 month ago
extension Update extension dependencies 5 days ago
native Update native dependencies 5 days ago
.editorconfig Add more distribution options and auto publishing 2 years ago
.gitattributes Add repository config files 2 years ago
.gitignore Add initial support (#118) 3 months ago
LICENSE Add repository license 2 years ago Make some links and documentation more consistent 3 months ago


Progressive Web Apps for Firefox

Release Users Rating License Repositories DEB RPM

A tool to install, manage and use Progressive Web Apps (PWAs) in Mozilla Firefox.


Progressive Web Apps (PWAs) are web apps that use web APIs and features along with progressive enhancement strategy to bring a native app-like user experience to cross-platform web applications. Although Firefox supports many of Progressive Web App APIs, it does not support functionality to install them as a standalone system app with an app-like experience.

This project creates a custom modified Firefox runtime to allow websites to be installed as standalone apps and provides a console tool and browser extension to install, manage and use them.


TLDR: Install the browser extension and follow in-browser installation instructions. Check the repository wiki for simple usage instructions.

For detailed and more technical documentation how to set up, use and develop the project, see the READMEs of the native and extension part:


Current Features

  • Command-line tool to install, manage and run Progressive Web Apps in Firefox.
  • Extension to set up native programs, and install, manage and run PWAs and their profiles directly from the main Firefox browser.
  • Isolated Firefox installation and profile(s) that stores the PWAs.
  • Installed PWAs have their own start/app menu entry and taskbar icon, and live in their own window.
  • Installed PWAs have tabs and address bar for a better app-like feel.
  • Support for installing all websites as Progressive Web Apps.
  • Support for all Firefox addons/extensions and built-in Firefox features.
  • Support for automatic (user-triggered) installation and patching of installation and profile(s).

Planned Features

  • Localization of most UI elements.
  • Support for more system-related web app manifest features (once they are standardized).

Not Planned Features

  • Integration into official Firefox code. This project currently modifies the browser chrome (UI) at runtime using JS and CSS. Although this works, it is officially unsupported by Mozilla and can break with Firefox updates. To contribute features back into the official Firefox code, they would need to be implemented properly with the new chrome page and browser services. Unfortunately, this requires an almost complete rewrite of the project, and I currently don't have enough knowledge and time to do that.

  • Using the same installation profile for PWAs and normal browsing. This could make the main browser installation/profile unstable if things break. It would also prevent customizing the PWA profile to work better as a PWA profile, and installing custom addons. If you want to sync data between your main and PWA profile, I recommend using Firefox Account or a third-party sync solution.

  • Running PWAs installed as Windows APPX/MSIX packages or from Microsoft Store. They will always use Chromium-based Edge that is installed on Windows 10/11. I'm not sure if it is possible to override this. If it is not too hard and doesn't cause any problems, I may try this in the future.

  • Support for Chromium-specific APIs (Filesystem, Bluetooth, NFC, USB...). This would require forking and directly modifying the Firefox source. Also, I'm not sure if giving websites the same privileges as native apps is the best idea...

Current Limitations

These are things that I would like to fix eventually, but will currently stay, either because they are too hard to fix, or would require modifying the Firefox source. I will appreciate any help to fix them.

  • All PWAs are merged with the first PWA that was opened (Linux & macOS):

    When some PWA is already running, all newly launched PWAs will merge with it and remain merged until all of them are closed. This will cause the app menu to display all PWAs as part of the first PWA that was launched, with its icon and desktop actions (if any).

    Users can prevent this by installing each PWA into a different profile.

    • Linux:

      This cannot be fixed easily. The native part of the project currently launches Firefox with the --class and --name arguments, which should set the WM_CLASS property of the window to the web app ID. However, because all Firefox processes in the same profile are connected together, all windows have WM_CLASS of the first web app. Fixing this would probably require modifying Firefox C++ code. Check this comment and related discussions for ideas and possible solutions to fix this.

      This problem is tracked as issue #80 and bug 1747722 on Bugzilla.

    • macOS:

      Apple only allows a process to be associated with a single application at all times. Perhaps this could be solved by using an IPC link between a host process and the main Firefox runtime process, the same way the Firefox parent process handles its content processes. This is just a wild theory though and has to be investigated further. See this comment for more.

      This problem is tracked as issue #81.

  • Extension cannot detect the native program when using sandboxed Firefox (Linux Flatpak):

    When using Firefox distributed as a Flatpak package, the extension cannot detect the native program that is used. This is because Flatpak packages are sandboxed and cannot access/run other programs which is needed for Native Messaging API. This cannot be fixed until Native Messaging API gets support to work in sandboxed browser packages.

    The workaround for this is to uninstall Flatpak-based Firefox and install a normal DEB package instead. See #76 for more details.

    Update: Previously, this problem was also present on Snap, but it has been fixed recently. If you still cannot detect the native program, make sure Firefox is up-to-date.

Contributors & Sponsors

Thanks to for sponsoring this project and providing us a free hosting for our DEB and RPM packages!

Private NPM registry and Maven, RPM, DEB, PyPi and RubyGem Repository · packagecloud


Thanks to all contributors to this project for providing help and developing features!



Thanks to all package maintainers making sure the project is up-to-date on all distributions, and donors for providing financial support for the project! Finally, thanks to Mozilla for creating Firefox and making it possible to modify the UI using JavaScript!


The project uses SemVer for versioning. For the available versions and the changelog, see the releases on this repository.

The native and extension part of the project at released tags are compatible with each other according to SemVer. The native and extension part at non-tagged commits may not be compatible with each other, because they are development versions that may not be both updated at the same time.

The project aims for compatibility with the latest stable Firefox version. It may not be compatible with the others.


The project is licensed under the Mozilla Public License 2.0. By using, redistributing, or modifying it, you must agree to the license, and the additional clauses provided below. See the LICENSE file for the full license text.

The project uses additional third-party assets and code:

Additional open source software will be downloaded and installed at runtime when initiated by the user:

  • Installing the runtime on Windows will install 7-Zip if it is not already installed. The 7-Zip project is made by Igor Pavlov and licensed under the GNU LGPL license and others. This project is not affiliated with the 7-Zip project or its developers in any way.

  • Installing the runtime on any system will download the unmodified Mozilla Firefox browser and locally modify it. By using this project, you also agree to the Firefox Privacy Notice. Firefox is licensed under the Mozilla Public License 2.0. Firefox and the Firefox logo are trademarks of the Mozilla Foundation in the U.S. and other countries. This project is not affiliated with the Mozilla Foundation in any way.