Cloud sync

Why cloud sync?

Posh works offline-first. Cloud sync adds backup, multi-device teams, and web orders. For a new store, saving the store profile unlocks the workspace immediately; a PIN is optional later in Settings. Cloud creation can finish in the background when online. Join and Restore still need internet and a code before the device opens.

• Same catalog and prices on every device
• Recover after reinstall or lost tablet with an operator recovery code
• Cashiers and inventory staff join with invite codes
• Sales and settings merge across registers
• Product images upload to cloud storage when sync is on

What syncs (and what does not)

Synced to cloud

• Products, categories, variants, prices, and on-hand quantities
• Sales, orders, customers, and receipts
• Stock receipts, suppliers, and store settings
• User profiles and tenant configuration

Device-local only (today)

• Stock movement ledger (per-item history timeline)
• Stocktake draft and posted sessions

Managing sync in Settings

Admins open Settings → Cloud sync to:

• See sync status (connected, last sync time, errors)
• Run manual sync now
• Generate invite codes (cashier or inventory staff role)
• Review sync log for troubleshooting

Cashiers and inventory staff use the Device tab for sync status and manual sync—they cannot generate invite codes. Store restore and admin PIN recovery codes are issued by Posh support after verification—not from Settings.

First-time connection paths

Create store (admin)

After local setup, Posh find-or-creates a cloud tenant tied to this device when online (or when you enable cloud sync in Settings). No codes needed. Pending or failed cloud setup never blocks inventory or clinical work on this device.

Join with invite code

1. Admin generates invite code in Settings and shares it securely.
2. New team member chooses Join store during first launch.
3. Enter invite code on the cloud connection step.
4. Posh pulls store data and registers the device.

Restore with recovery code

1. Contact Posh support from Settings → Developer contact (or the help site). Support verifies store ownership and issues a one-time restore code.
2. On the replacement device, choose Restore during first launch.
3. Enter the recovery code when prompted.
4. Catalog and settings download from cloud.

Troubleshooting sync

• Sync failed — check internet, then tap Sync now. Expand the sync log in Settings for error detail.
• Invite or recovery rejected — codes are single-use and may expire. Ask an admin for a new invite, or contact support for a new restore code.
• Device limit reached — POS subscription includes two team devices. See billing or contact support.
• Stale catalog on cashier tablet — run manual sync on the cashier device after admin edits products.

Security

Sync credentials are configured at app build time—you never type Supabase URLs or keys in the app. Your store is isolated by tenant; invite codes and operator-issued recovery codes prove membership without sharing a device PIN.

Related topics

• Getting started
• Users & roles
• FAQ & troubleshooting