Offline mode

How Taskloc works without internet — what is available offline, how the queue of updates to the tracker works, the task cache and several organizations offline

Updated:

What works offline

Taskloc is designed so that the main operations on tasks work even without internet.

FeatureOffline
Viewing tasks and the task description (from the cache)Yes
Loading task comments and history from the trackerNo
Commenting on a taskYes (queued)
Changing the statusYes (queued)
GPS tracking (start/stop)Yes (queued)
Uploading attachmentsYes (queued)
TimerYes (queued)
Searching loaded tasksYes
Finding a task by number in the trackerNo
Switching the organizationYes (see below)
Voice commandsYes (after downloading the model, if one is needed)
Creating a taskNo
Route listNo
My mileageNo
Refreshing the task listNo

How the queue works

When you do something offline (leave a comment, stop tracking, upload a file), the app:

  1. Saves the action to a local queue on the device.
  2. Shows the result in the UI as if the action were done.
  3. Once the connection is back, automatically sends all pending operations to the tracker and to the Taskloc server.

On the task card, pending operations are reported by the "N changes pending upload" chip. Offline it is visible right away. Online an operation usually goes out within seconds, so the chip appears only if it has not gone out within 30 seconds — that is, it is stuck.

The queue is durable: no data is lost, even if you close the app or restart the phone.

Task cache

The task list is cached locally. Offline, you see the last loaded state. There is no "cache is stale" label — the app quietly works with what it has.

The cache is refreshed when:

  • You open the app (if there is a network).
  • You pull to refresh.
  • You switch a filter chip.

If you pull the list down offline, the app answers briefly: "No connection — working in offline mode" — the gesture does not end in silence.

Offline, the task card shows what is saved: the title, status and description. Comments and history from the tracker load only when online — see Tasks.

Multiple organizations offline

If you work in several organizations, you can switch between them without internet too — just as online: pick an organization, and the task list is rebuilt immediately. Offline, the organization picker shows a hint: switching works, but invitations and connecting a tracker do not.

  • Tasks of another organization are shown from the phone's memory — if you have already opened that organization on this device.
  • For an organization you have never opened on this phone, there is nothing to show offline — the screen says so: "This organization has never been opened on this device — there is nothing to show offline." Go online to load its tasks.
  • The server learns about your choice once the network is back. Until the choice is synced, an icon is shown next to the organization name, and the picker says "The choice made on … is not synced with the server yet". If you switched several times, the last choice wins.
  • A session does not move to another organization. A GPS session started offline remembers the organization at the moment it started — switching later does not redirect it.

Routes and reports — online only

The Routes and My mileage sections and other aggregates require internet. Without a connection, a No connection banner appears. This is intentional: routes and mileage are server data, and no local cache is kept so that stale data is never shown.

Trip readiness

Before heading somewhere without reliable coverage, open Settings → Diagnostics → Trip readiness. One screen shows whether everything is ready for offline work:

  • Permissions — precise location, notifications, battery restrictions.
  • Tracker sign-in — whether the Taskloc sign-in and each tracker sign-in are still valid.
  • Delivery queue — whether everything has been sent; send what is left while you still have a network.
  • Tasks on this device — how fresh the list is. Download my tasks loads the cards and comments of the tasks assigned to you in advance.
  • Offline maps — whether the downloaded maps cover the sites of tasks with a pinned location.
  • Connectivity — Check now tests whether the server, the trackers and the maps respond.

Each item has its own status: Ready, Attention or Problem. If there are problems, the app's notifications show a "Not ready for a trip" row — tapping it opens the check. This check never blocks work — it is a hint before you leave.

Session expired

If your authorization token has expired (you were offline for a long time), the app tries to re-authorize automatically once the network is back — without asking for a password. If that fails (for example, your Redmine password has changed), a "Taskloc session expired" banner appears with a Sign in button. All accumulated GPS tracks and queued operations are kept on the device and are sent after you sign in.