Free trial
Colour

Working offline on the Mac

Keep working when the network drops: what you can read, what waits in the queue, and what happens when the connection returns.

For
OwnerDispatcherService advisorTechnician
Hosting
Any hosting
Devices
Mac
Business
All businesses

Checked against Pop Street Dispatch 0.1.0

The Mac app keeps working when the server cannot be reached. You will be able to read the last copy of each screen and keep taking changes, and the app sends them when the connection returns.

How it works #

  1. Every screen you open is saved on this Mac. When the server cannot be reached, the screen shows the saved copy and a banner with the time it was saved.
  2. A change you make while offline goes into a queue on this Mac. The connection chip shows Offline and the number of changes waiting. The change shows Pending where it appears.
  3. When the connection returns, the app sends the queue in order. Each change carries its own key, so the server stores it once even if the connection drops during the send. You can also choose the connection chip, or Command-Shift-S, to send at once.
  4. If the server refuses a change, the app shows the reason under Settings and does not send it again. A busy server or a short outage leaves the change in the queue to be tried again.

What waits for the server #

Assigning a driver and a truck, moving a call, recording a payment and taking a call all wait in the queue. Sign-in and password changes never wait; they need the server.

If something goes wrong #

  • "The server cannot be reached and this Mac holds no earlier copy of this screen": open the screen once while online.
  • A change stays Pending for a long time: check the server address under Settings.
Technical details

The queue and the saved copies live in one encrypted file in the app's support folder. The queue sends a change again after a timeout, a 429 or a 5xx answer, with the same idempotency key. Any other 4xx answer is shown and kept as refused. Signing in on another account on the same Mac keeps each person's copies and queue apart.