1. "Add OmniRoute to Home screen" banner automatically, or:
   ⋮ menu (three dots) → "Add to Home screen" or "Install app"

1. Share button (box with arrow)
2. "Add to Home Screen"
3. Add

1. install icon in the address bar (or ⋮ → "Install OmniRoute...")

, which means the installed app uses the entire screen — no browser chrome, no status bar overlap. This makes the dashboard feel truly native.

) that provides intelligent caching:

App Shell		, , manifest, and icons are pre-cached on install
Static assets (CSS, JS, images, fonts)
Next.js bundles ()
Navigation requests		page if network is unavailable
API routes (, , )

page that:

"Connectivity Issue" message
• online/offline status indicator that updates in real time
• "Retry Connection" button to reload when connectivity returns
• Status Page for diagnostics

component in the root layout. No user action is needed — the app becomes installable as soon as the browser detects the valid manifest and service worker.

)

:

{
  "name": "OmniRoute",
  "short_name": "OmniRoute",
  "description": "OmniRoute is an AI gateway for multi-provider LLMs. One endpoint for all your AI providers.",
  "start_url": "/",
  "scope": "/",
  "display": "fullscreen",
  "orientation": "any",
  "background_color": "#0b0f1a",
  "theme_color": "#0b0f1a",
  "icons": [
    { "src": "/icon-512.png", "sizes": "512x512", "type": "image/png", "purpose": "any maskable" },
    { "src": "/apple-touch-icon.png", "sizes": "180x180", "type": "image/png" }
  ]
}

)

Install phase: Pre-caches the app shell (root, offline page, manifest, icons)
• Activate phase: Cleans up old cache versions and claims all clients
• Fetch phase: Intelligent routing based on request type (navigation, static asset, API)
• Cache versioning: — bump this to force a fresh cache on update

)

link to
• for iOS standalone mode
• for Android Chrome
• for edge-to-edge rendering

, this client component:

1. support in the browser
2. silently (errors are swallowed to avoid blocking the app)
3. ) — it's a side-effect-only component

server (Termux) and the client (PWA) — a complete self-contained AI gateway.

Another phone/tablet: Navigate to and install the PWA
• Laptop: Open Chrome/Edge and install it as a desktop PWA
• Smart TV with browser: Access the dashboard fullscreen

Instance Name setting from . If you rename your instance to "My AI Gateway", the installed PWA will show that name.

, the PWA icon on desktop will reflect the custom icon. Mobile home screen icons use the pre-built and files.

No push notifications — The service worker does not implement the Push API. Notifications are handled by the Electron app instead.
• No background sync — Offline actions are not queued for replay. The PWA is primarily a dashboard viewer.
• iOS restrictions — Safari on iOS does not support all PWA features (e.g., install prompts are manual, and background service workers are limited).
• Cache size — The service worker caches static assets only. Large response payloads from routes are never cached.
• Custom icons on mobile — Changing the favicon in settings does not update the home screen icon on mobile (this requires regenerating the PWA icons).

	)