Skip to main content

How offline mode works

Barns don't have good Wi-Fi. OmniBurrow is built for that: the Mobile App keeps a complete copy of your rabbitry on your device, so you can work whether or not you have a signal. This page explains what that means and why your data is safe.

:::info Mobile-first True offline mode is a Mobile App capability — your phone holds the local database. The Web App works over a live connection. Both read and write the same account; they just reach it differently. :::

Your data lives on your device first​

The Mobile App stores everything — rabbits, litters, weights, health events, finances — in a fast on-device database. When you add a weight or log a litter in the barn:

  1. It's saved to your phone immediately, with no network needed.
  2. The change is added to an outbox — a queue of things waiting to reach the server.
  3. The next time you have a connection, the app drains the outbox and sends your changes up, and pulls down anything new from the server.

Because the write happens locally first, the app never makes you wait on a signal, and you don't lose work if you walk out of Wi-Fi range mid-task.

What "sync" actually does​

Sync runs in two directions:

  • Push — your queued local changes go up to the server.
  • Pull — changes made elsewhere (the Web App, or another device) come down to your phone.

It runs automatically when you have a connection, and can also run in the background so your devices stay close to up-to-date without you opening the app. If two devices each change something while offline, see Conflicts below.

Practically everything works offline​

Nearly the entire app works without a signal — rabbit and litter records, weights, selling a rabbit (queued), line analytics, pedigree PDFs, and even predicting offspring (the genetics calculations run on-device). The main exception is multi-account transfers, which need both accounts online at once by design.

Conflicts (when two devices disagree)​

If the same record is edited in two places before they sync, OmniBurrow detects the collision rather than silently overwriting one side. Most fields merge automatically using a "last-write-wins" rule; sensitive fields are protected and surfaced to you to resolve. When that happens you'll get a notification and the record waits for your decision.

This is important enough to have its own guide: Conflict Resolution.

What you should know as a user​

  • Don't worry about losing barn data. It's saved on your device the instant you tap save.
  • Give it a moment to catch up. After you're back on Wi-Fi, sync runs automatically; a brand new record may take a few seconds to appear on your other devices.
  • If something looks out of date on the Web App, the phone may not have synced yet — open the app with a connection to let the outbox drain.
  • A flagged conflict isn't lost data — it's OmniBurrow asking which version you want to keep.

:::note Screenshot needed: Mobile sync status / diagnostics screen showing pending outbox items :::

Last updated on