Skip to content

Add PWA install prompt and offline fallback page #233

Description

@Chuks-coderr

Overview

SoroStream should be installable as a Progressive Web App on mobile and desktop. An install prompt and offline fallback page make the app feel native and accessible without an internet connection.

Problem

There is no PWA manifest or service worker. Users on mobile must open the app in a browser every time and cannot install it to their home screen. Offline visits show a browser error page.

Proposed Solution

  • Add a manifest.json with app name, icons, theme color, and display: standalone
  • Implement a service worker that caches the app shell for offline use
  • Add an install prompt banner that appears after the user has visited twice
  • Create a custom offline fallback page showing cached stream data when available

Acceptance Criteria

  • App passes Lighthouse PWA audit with no critical failures
  • Install prompt appears on the second visit on mobile browsers
  • Offline fallback page displays instead of browser error when network is unavailable
  • Service worker caches app shell assets and serves them offline
  • Manifest icons are present at required sizes (192px, 512px)

Metadata

Metadata

Assignees

No one assigned

    Labels

    complexity: highComplex feature, refactor, or new integrationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions