Submissions, photos, or signatures aren't syncing

How sync works

Every submission, photo, and signature is queued in IndexedDB on the worker's device the moment it's saved. When the device reconnects to the internet, the service worker flushes the queue automatically, silently, in the background.

Check the queue

In the worker app, look at the Offline Status chip at the top. It shows pending submissions and their state. If you see "Stuck," tap the chip; the system surfaces the specific error and offers a retry.

Common causes

• Trial expired. If a tenant's 30-day trial has ended, the database refuses writes with code 42501. Sub­scribe and the queue flushes on the next attempt.
• Bad attachment. A corrupt photo file can stop one submission. The Offline Status panel names the offending file; remove or replace it and the rest will sync.
• Auth expired. If the worker has been signed out for too long, they'll be asked to re-login when the queue tries to flush. After re-login the queue resumes.

Force a flush

The PWA polls for sync every 30 minutes when online. To force one immediately, tap the Offline Status chip → Flush queue in the worker app.