Auto-update the installed Home Screen app (Android + iOS)

[CarlosA49]

Summary

Makes the installed Home Screen app (Android + iOS PWA) automatically pick up new deploys instead of serving stale cached content.

• SW install now fetches every shell file with cache:"reload", so a new service worker always stores the freshly deployed HTML/JS/CSS (bypasses the HTTP cache). Combined with the existing skipWaiting() + clients.claim() + old-cache cleanup, a new version fully takes over.
• Page side: when a new SW takes control, the page reloads once so the user immediately sees the new build. Guarded with a swRefreshing flag and a hadController check → never loops, never reloads on first install.
• Update checks: registration.update() runs on load, again whenever the app is foregrounded (visibilitychange — installed PWAs resume from background without a navigation), and hourly while open.
• Offline still works (cache-first fetch unchanged); sw cache → v7.

How it behaves

Deploy → user opens the Home Screen app (or it resumes) → SW update detected → new shell cached fresh → new SW activates → page auto-reloads once → latest version shown. No manual reinstall.

Test plan

• Install to Home Screen (Android Chrome + iOS Safari)
• Deploy a visible change; reopen the installed app → it updates automatically within a launch (brief one-time reload)
• First-ever install does NOT cause an extra reload / loop
• Offline launch still loads the cached app
• Python tests still pass

https://claude.ai/code/session_015REKyF6JmJchTnZWoLth7Y

---

Generated by Claude Code