Configure the installable mobile web app
Where: Admin → System → Appearance → Mobile app (PWA)
Before you start
A PWA is an installed web experience, not a native app-store release. The manifest is published at manifest.php while enabled. Browser installation UI depends on browser/platform policy; enabling the switch does not guarantee an immediate popup.
Step by step
- Enable Publish a web app manifest.
- Set App name, Short name, Theme colour and Splash background.
- Upload a square PNG icon, 512×512 or larger. Save changes.
- Visit the public HTTPS site in a supported browser and use its Install/Add to home screen control.
Settings and behaviour
A PWA is an installed web experience, not a native app-store release. The manifest is published at manifest.php while enabled. Browser installation UI depends on browser/platform policy; enabling the switch does not guarantee an immediate popup.
Installable app
| With this on, the board publishes a web app manifest at manifest.php and the header links it, which is what makes a browser offer Install. | Control | What to enter / effect |
|---|---|---|
| Publish a web app manifest | Initial default: 1. |
|
| App name | Defaults to the site name. Initial default: empty. | |
| Short name | Under the icon on a home screen. Twelve characters or so. Initial default: empty. | |
| Theme colour | Initial default: #0f1117. |
|
| Splash background | Initial default: #0f1117. |
|
| App icon | A square PNG, 512×512 or larger. Upload one; the board stores it. Initial default: empty. |
Check the result
Inspect the manifest and the installed name/icon on a supported device.
Common questions and troubleshooting
No install prompt: check HTTPS, manifest enablement, icon and browser menu. Old icon: installed apps and browser caches may retain it; test a fresh installation.