Installing the PWA
The client app is a PWA — installable to the home screen on iOS and Android. Tell new clients to install it on day one so they get push notifications and proper offline behavior.
Why install matters
Without installing, push notifications won't fire (especially on iOS which strictly requires PWA install), and the home-screen icon experience is just a browser tab. Once installed, it behaves like a native app — its own icon, splash screen, full-screen mode, offline workout logging.
Android Chrome — the easy path
- Open the client PWA login URL in Chrome (the link in the onboarding email).
- Sign in. After login, a banner slides up: "Install INGOT".
- Tap Install. Android adds the icon to the home screen and registers the service worker.
- If they miss the banner, they can tap the three-dot menu in Chrome → Install app.
iOS Safari — the manual path
iOS doesn't show an automatic install prompt. Clients have to walk through the share-sheet flow. Tell them to:
- Open the client PWA URL in Safari specifically (not Chrome on iOS — that won't install as a PWA).
- Tap the Share button (square with up-arrow) in the bottom toolbar.
- Scroll down in the share sheet and tap Add to Home Screen.
- Confirm. The icon appears on their home screen.
- Open from the home screen icon (NOT from Safari). Sign in. Allow notifications when prompted.
Once installed
- Push notifications work (after they grant permission). They get pings for new messages, sent reports, and scheduled session reminders.
- Offline mode kicks in. They can log workouts in a gym with no signal — everything syncs the next time they're online.
- Branded experience — your logo and brand color (Business tier) show on the splash screen and throughout the UI.
Common gotchas
- iOS user opens in Chrome → can't install. Direct them to Safari. iOS only supports PWA install from Safari.
- Install banner doesn't show on Android. They may have dismissed it once. Three-dot menu → Install app still works.
- "Allow notifications" gets denied. They can re-enable in OS settings → Apps → INGOT → Notifications. Or uninstall + reinstall the PWA.