PWA: offer to install (Chromium prompt, iOS "Add to Home Screen" hint) #116

Closed
opened 2026-09-17 13:29:43 -04:00 by jared · 1 comment
Owner

Verified 2026-09-17: the client never handles beforeinstallprompt and shows no install hint, so phone users only get the PWA if they know to dig for Share → Add to Home Screen (iOS never prompts on its own; Chromium's mini-infobar is easy to miss).

Scope

  • Capture beforeinstallprompt (Chromium) and show a sticky toast "Install Lotus Chat" from the second visit; tapping it calls prompt().
  • iOS Safari: same toast with "tap Share, then Add to Home Screen" instructions.
  • Never inside the Tauri app or an already-installed PWA (display-mode: standalone / navigator.standalone); snooze 30 days on dismiss (X or tap); hide for good after appinstalled.
  • Browsers with no install path (Firefox desktop) get nothing — no noise.
  • Pure decision logic unit-tested (utils/pwaInstall.ts).
Verified 2026-09-17: the client never handles `beforeinstallprompt` and shows no install hint, so phone users only get the PWA if they know to dig for Share → Add to Home Screen (iOS never prompts on its own; Chromium's mini-infobar is easy to miss). ### Scope - Capture `beforeinstallprompt` (Chromium) and show a sticky toast "Install Lotus Chat" from the **second** visit; tapping it calls `prompt()`. - iOS Safari: same toast with "tap Share, then Add to Home Screen" instructions. - Never inside the Tauri app or an already-installed PWA (`display-mode: standalone` / `navigator.standalone`); snooze 30 days on dismiss (X or tap); hide for good after `appinstalled`. - Browsers with no install path (Firefox desktop) get nothing — no noise. - Pure decision logic unit-tested (`utils/pwaInstall.ts`).
jared added this to the Features 2026-Q4 milestone 2026-09-17 13:29:43 -04:00
jared added the enhancementpriority: mediumuxarea: mobile labels 2026-09-17 13:29:43 -04:00
jared self-assigned this 2026-09-17 13:29:43 -04:00
jared closed this issue 2026-09-17 13:41:18 -04:00
Author
Owner

Shipped in bd1e61e8. Live check: open chat.lotusguild.org in a fresh Chrome profile twice (second visit, wait ~6 s) → sticky Install Lotus Chat toast; tap → browser install dialog. iOS Safari (not installed) → the Share → Add to Home Screen hint. Inside the installed PWA or the desktop app → nothing.

Shipped in `bd1e61e8`. Live check: open chat.lotusguild.org in a fresh Chrome profile twice (second visit, wait ~6 s) → sticky *Install Lotus Chat* toast; tap → browser install dialog. iOS Safari (not installed) → the Share → Add to Home Screen hint. Inside the installed PWA or the desktop app → nothing.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: LotusGuild/cinny#116