> ## Documentation Index
> Fetch the complete documentation index at: https://help.propops.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Progressive Web App

> Install PropOps on desktop and mobile as a native-like app with offline caching and home-screen support.

PropOps Web is a **Progressive Web App (PWA)** — it can be installed directly from the browser onto any desktop or mobile device, providing a native app experience without an app store.

***

## Features

<CardGroup cols={2}>
  <Card title="Installable" icon="download">
    Add PropOps to your home screen or desktop. It launches in its own window, just like a native app.
  </Card>

  <Card title="Offline caching" icon="wifi-slash">
    A service worker caches essential assets so the app loads instantly, even on slow or intermittent connections.
  </Card>

  <Card title="Push notifications" icon="bell">
    Receive real-time push notifications on desktop and mobile, even when the browser is closed.
  </Card>

  <Card title="iOS support" icon="apple">
    Full home-screen support on iOS devices with a custom splash screen and icon.
  </Card>
</CardGroup>

***

## Installing the app

<Tabs>
  <Tab title="Desktop (Chrome / Edge)">
    1. Open PropOps in your browser
    2. Click the **install icon** in the address bar (or the three-dot menu → **Install PropOps**)
    3. Click **Install**
    4. PropOps opens in its own window and appears in your app launcher
  </Tab>

  <Tab title="Android">
    1. Open PropOps in Chrome
    2. Tap the **Add to Home Screen** banner (or menu → **Install app**)
    3. Tap **Install**
    4. PropOps appears on your home screen
  </Tab>

  <Tab title="iOS (Safari)">
    1. Open PropOps in Safari
    2. Tap the **Share** button
    3. Tap **Add to Home Screen**
    4. Tap **Add**
    5. PropOps appears on your home screen with its own icon and splash screen
  </Tab>
</Tabs>

***

## Service worker

The service worker handles:

* **Asset caching** — CSS, JavaScript, and images are cached locally for fast load times
* **Offline fallback** — essential pages remain accessible when the network is unavailable
* **Background sync** — queued actions are retried when connectivity is restored

***

## Web app manifest

The `manifest.webmanifest` file defines how PropOps appears when installed:

| Property         | Value                                    |
| ---------------- | ---------------------------------------- |
| **Name**         | PropOps                                  |
| **Display**      | Standalone (no browser chrome)           |
| **Orientation**  | Any                                      |
| **Theme colour** | Matches your organisation's brand colour |
| **Icons**        | Multiple sizes for all device types      |
