Offline and local data (desktop)
What you will learn
Section titled “What you will learn”What offline means on Vendor Desktop, and when cashiers can still sell without live API.
This page is for cashiers and store managers. Engineering detail: POS local-first (desktop).
When offline mode applies
Section titled “When offline mode applies”| Surface | Offline selling |
|---|---|
| Vendor Desktop (Electron) | Yes — local SQLite + order outbox (when flags enabled) |
| Browser only | Limited — drafts in browser storage; place-order needs network |
What is cached locally (desktop)
Section titled “What is cached locally (desktop)”- Catalog snapshot for the selected store.
- Lanes, devices, store configuration, open work shift.
- Order outbox — payloads waiting to sync when online.
Typical offline flow
Section titled “Typical offline flow”- Network drops during a busy period.
- Cashier continues adding lines (from cache).
- Place order writes to outbox; display code may show a local order number.
- When online returns, outbox syncs to the server.
Reset local data
Section titled “Reset local data”If cache is corrupt or after training:
- Settings → Local data (desktop only).
- Optional backup is created automatically.
- Clear catalog cache (and optionally outbox) for the current store.
See Local data reset.
Expected result
Section titled “Expected result”Staff understand when to wait for sync vs continue selling on desktop.
Common issues
Section titled “Common issues”| Symptom | See |
|---|---|
| Duplicate orders after reconnect | FAQ — offline & sync |
| Old prices on screen | Reset local data or wait for catalog refresh |