Install Prompt Not Showing
Use manual install as a separate check from prompt eligibility.
| Symptom | Likely cause | Fix |
|---|---|---|
| No install icon in browser UI | Manifest errors, unsupported browser, already installed, or weak criteria | Check DevTools Manifest, uninstall old app, try manual menu |
beforeinstallprompt never fires | Browser unsupported or prompt criteria not met | Provide manual install instructions and fix manifest/engagement issues |
| App opens in browser tab | display missing or unsupported | Set display: standalone and retest target browser |
| Installed app opens wrong URL | Bad start_url | Use stable launch route that handles auth/offline |
| Navigation leaves app window | Scope too narrow | Set scope to the app route root |
| Icon looks cropped | No maskable icon or unsafe padding | Add maskable icon with safe zone |
Debug Order
- DevTools Application, Manifest.
- Network check for manifest and icon URLs.
- Manual browser menu install.
beforeinstallpromptevent logging.- Real target device test.