> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wrkit.osamapm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Wrk It as an app on your phone or computer

> Add Wrk It as a PWA to your Android, iOS, or desktop home screen for a native app experience with offline access, faster loading, and push notifications.

Wrk It is a Progressive Web App (PWA), which means it runs like a native app on your device without going through an app store. When you install it to your home screen, it opens in a full-screen experience without browser chrome, loads faster on repeat visits, works offline for core features, and — critically on iPhone — enables push notifications. The install takes under a minute on any platform.

## Why install to your home screen

Installing Wrk It gives you several benefits over using it in a browser tab:

* **Offline access** — the app loads even when you don't have a connection, so you can log habits without waiting for a network.
* **Full-screen experience** — no address bar or browser tabs; the app feels native.
* **Faster loading** — assets are cached locally after the first visit.
* **Push notifications** — receive habit reminders directly on your device.
* **Home screen shortcut** — launch Wrk It directly from your home screen or app drawer, just like any other installed app.

<Warning>
  On iPhone and iPad, push notifications for web apps only work when Wrk It is installed to your home screen. You will **not** receive habit reminders from a regular Safari tab, even if you grant notification permission. Install the app to your home screen to enable push notifications on iOS.
</Warning>

## How to install

<Tabs>
  <Tab title="Android (Chrome)">
    The easiest way to install on Android is to use the **Install** banner that Wrk It displays automatically after you've used the app for a short time.

    <Steps>
      <Step title="Wait for the install banner">
        After using Wrk It, an **Install** banner appears at the center of the screen. Tap **Install App** to install directly.
      </Step>

      <Step title="Or install from the browser menu">
        If the banner has been dismissed, open Chrome's menu (three-dot icon in the top right corner) and tap **Add to Home Screen**.
      </Step>

      <Step title="Confirm the install">
        Tap **Add** in the prompt that appears. Wrk It is added to your home screen and app drawer.
      </Step>
    </Steps>
  </Tab>

  <Tab title="iOS (Safari)">
    Installing on iPhone or iPad requires Safari. The install option is not available in Chrome or other third-party browsers on iOS.

    <Steps>
      <Step title="Open Wrk It in Safari">
        Navigate to the Wrk It app URL in Safari on your iPhone or iPad.
      </Step>

      <Step title="Tap the Share button">
        Tap the **Share** button at the bottom of the screen (the square with an arrow pointing up).
      </Step>

      <Step title="Tap Add to Home Screen">
        Scroll through the share sheet and tap **Add to Home Screen**.
      </Step>

      <Step title="Confirm">
        Tap **Add** in the top right corner to confirm. The Wrk It icon appears on your home screen.
      </Step>
    </Steps>

    <Note>
      Push notifications are only available on iOS 16.4 and later. If you're on an older version of iOS, you can still install the app and use all other features, but you won't receive push notification reminders.
    </Note>
  </Tab>

  <Tab title="Desktop (Chrome / Edge)">
    On desktop, Chrome and Microsoft Edge both support installing Wrk It as a standalone app window.

    <Steps>
      <Step title="Look for the install icon">
        In Chrome or Edge, look for a small install icon (a monitor with a download arrow) on the right side of the address bar.
      </Step>

      <Step title="Click the install icon">
        Click the icon. A prompt appears asking you to confirm the install.
      </Step>

      <Step title="Click Install">
        Click **Install**. Wrk It opens in its own app window, separate from the browser, and a shortcut is added to your taskbar or dock.
      </Step>
    </Steps>

    <Note>
      If the install icon doesn't appear in the address bar, open the browser menu (three-dot icon) and look for **Install Wrk It** or **Save and share → Install page as app**.
    </Note>
  </Tab>
</Tabs>

## The install banner

Wrk It displays an install banner automatically once you've signed in and completed onboarding. The banner appears as a modal in the center of the screen with platform-specific instructions. If you dismiss it by tapping **Not now**, it won't show again immediately, but you can still install the app manually using the steps above for your platform.