PWA Architecture & Service Worker Lifecycle

Cora ships with native Progressive Web App (PWA) capabilities, offering sub-50ms screen painting and native-like offline reliability.

1. Dynamic PWA Manifest

Served dynamically at /cora-manifest.json:

• display: standalone
• theme_color: #ffffff (Pure Light Mode splash to eliminate dark flashes)
• Dynamic version stamps (?v=CORA_WORKSPACE_VERSION) to trigger immediate OS icon updates on release.
• Role-scoped manifest routing: super administrators receive distinct scope (/workspace/dashboard?role=admin) and dedicated app naming.

2. Service Worker Lifecycle

Registered at root scope (/):

• Cache-First: Static CSS/JS and font assets.
• Network-First: AJAX actions and REST endpoints with sub-400ms timeout.
• Auto-Activation: skipWaiting() and old version cache purging executed on update within 300ms.

3. VAPID Push Implementation

• Cryptographically signed Web Push (RFC 8291/8292) using local ECDSA P-256 keys without third-party gateways.
• In-app push notification preference center per device.

4. Super Admin Dynamic Badging

• Super admin sessions dynamically render badged home screen icons (ADMIN pill badge across 512x512, 192x192, and Apple Touch icons via scripts/generate_admin_pwa_icons.php).
• Prevents visual confusion between client workspace and master control plane on mobile home screens.

5. Universal PWA Install Suite (v4.9.356+)

Cora provides persistent, frictionless PWA installation triggers across desktop and mobile devices:

• Settings Suite Trigger: #cora-settings-install-pwa-btn inside Settings Suite enables 1-tap installation directly from workspace preferences.
• Sidebar Admin Popover Trigger: #cora-sidebar-install-pwa-btn inside the sticky sidebar bottom popover allows instant access from any screen.
• Unified `window.coraPromptPwaInstall()` Engine: Gracefully handles the native beforeinstallprompt browser prompt event, while rendering contextual monochromatic platform guidance on iOS Safari (Share → Add to Home Screen).