Mobile and PWA install

Why install as a PWA

A PWA install gives you a standalone window, a homescreen icon, offline access to a curated subset of pages (the empty state, the docs index, your saved drafts list), and push-notification support on platforms that allow it.

It is NOT a different app. The PWA wraps the same web app — your data, your audits, and your drafts are identical to what you see in the browser.

Install on iOS (Safari)

1. Open the platform in Safari (other browsers on iOS can't install PWAs).
2. Tap the Share icon at the bottom of the screen.
3. Scroll down and tap Add to Home Screen.
4. Confirm the name. Tap Add.

You'll see an icon on your home screen. Tap it to launch the PWA. The first launch may take a moment to register the service worker.

Install on Android (Chrome)

1. Open the platform in Chrome.
2. Tap the ⋮ menu in the top right.
3. Tap Install app (or Add to Home screen on older builds).
4. Confirm. Chrome adds the icon and registers the install.

Some Android browsers (Firefox, Samsung Internet) support PWA install via similar menus. Edge on Android also works.

Install on desktop (Chrome, Edge, Brave)

1. Open the platform.
2. Look in the address bar for the install icon — a small monitor with a down arrow.
3. Click it. Confirm Install.

The PWA opens as a standalone window with the app's icon in your Dock or Taskbar. Right-click the icon for the OS-specific options (pin, uninstall, open at login).

What works offline

Service-worker cache covers:

• The docs index and any docs you've viewed recently
• The sign-in page (with a friendly offline notice)
• Your most recent dashboard view (read-only)
• Static assets — logos, fonts, the CSS bundle

What does NOT work offline:

• Running a new audit
• Generating new content
• Publishing
• Anything that mutates server state

We deliberately fail-fast on network operations when offline rather than queue them — silent queueing leads to ghost state on reconnect.

Push notifications

Push works on Android Chrome, desktop Chrome / Edge / Brave / Firefox, and iOS Safari 16.4+ when installed as a PWA. We use push for:

• Audit completion ("your weekly audit is ready")
• Approval requests ("X drafts waiting on your review")
• Mention alerts ("your brand was cited on Engine X for prompt Y")

Toggle individual channels at Settings → Notifications → Push.

Uninstalling

• iOS: long-press the home-screen icon → Remove App → Delete from Home Screen.
• Android: long-press the icon → Uninstall.
• Desktop Chrome / Edge: open the PWA → ⋮ menu → Uninstall (your data stays in the browser).

Troubleshooting

• The install button doesn't appear. Make sure you're on HTTPS, in a supported browser, and the service worker has registered. Open the browser's app-info panel — if the manifest is invalid, install is suppressed.
• The PWA looks stale after deploy. The service worker updates in the background but only swaps in on a fresh launch. Close the PWA window completely and re-open to pick up changes.
• Push doesn't fire on iOS. iOS requires the PWA to be installed from Safari and notifications to be explicitly granted. Re-installing usually resets the state.