← Back to Help

Offline capture and installing the app

How the offline queue works, installing LedgeIt as a PWA on iOS and Android, and troubleshooting the offline badge.

Screenshot of Offline capture and installing the app
Offline capture and installing the app in LedgeIt

LedgeIt works as a Progressive Web App (PWA). You can install it to your home screen and it keeps working when you lose signal — receipts and expenses queue up locally and sync as soon as you're back online.

Installing on your phone

  • iPhone (Safari) — tap the Share icon → Add to Home Screen.
  • Android (Chrome) — tap the ⋮ menu → Install app (or accept the install prompt when it appears).
  • Once installed it opens full-screen, without browser chrome, and shows up in your app switcher.

The offline queue

  1. Capture receipts or log expenses / mileage exactly as you would online.
  2. Each item is stored on your device and shown with a small Queued badge.
  3. When your connection returns, items sync in the background — the badge clears and you'll see a confirmation toast.
  4. Tap the badge in the top bar to see what's still queued.

The offline badge

A small Offline badge appears in the top bar when LedgeIt can't reach the server. It clears automatically the moment a background probe succeeds. In the Lovable preview and local dev the badge is suppressed because those environments aren't a real network.

If it stays visible on a device you know is online:

  • Try refreshing the page — a stale service worker sometimes needs a nudge.
  • Check that a corporate firewall or VPN isn't blocking the LedgeIt domain.
  • If nothing else works, uninstall and reinstall the PWA from your home screen — this clears the local cache.

What isn't available offline

  • Reports, exports and the billing portal — these need a live connection.
  • OCR runs server-side, so receipts you capture offline show up with placeholder details and are OCR-processed once they sync.