Description

The provided documentation on using firefoxpwa on alternative browsers (at least on MacOS) does not work. I have a suggestion ... :-)

Steps to Reproduce

Follow the instructions given here:

https://pwasforfirefox.filips.si/help/faq/#how-to-use-an-alternative-browser-as-an-app-browser

In this case for Waterfox on MacOS installed with the Homebrew cask.

Additional Information

Trying to (manually) launch the browser on the CLI kills it immediately (likely as well when using the browser UI):

$ runtime/Firefox.app/Contents/MacOS/firefox 
Killed: 9                  runtime/Firefox.app/Contents/MacOS/firefox

When changing the instruction to use a symbolic link instead of a hard link everything works as expected. This is the change:

ln -s waterfox firefox

So a simple update in the documentation should suffice.

Affected Websites

Any/all.

Environment

• Operating system: MacOS Sequoia 15.7.2
• System architecture: Apple/ARM M3
• Installation method: Homebrew cask
• PWAsForFirefox extension version: 2.17.2
• PWAsForFirefox native version: 2.17.2
• PWAsForFirefox runtime version: Waterfox 6.6.6
• Firefox version: Waterfox 6.6.6