What is Veldriq Field?
Veldriq Field is a native Flutter application for technicians who run assigned visits on Android and iOS. You compile the source. It talks only to your Veldriq Web origin.
It is not the Field PWA (browser client included with Veldriq Web). Buying Veldriq Web does not include this SKU. Native Field cannot run without an eligible Veldriq backend.
Screen path after a session: Today · Jobs · Sync · Profile. Job detail is a stack route, not a fifth tab.
Preconditions
Section titled “Preconditions”| Layer | Required |
|---|---|
| Binary | Compiled with an origin-only API_BASE_URL |
| Licence | Field Active / Revalidation due / Grace on that deployment |
| Actor | Active workspace membership + field.workspace.view + Active technician profile |
| Work | Office already assigned an appointment to you |
Buying this app does not create assignments. A CMS User without a technician profile cannot open Field.
Who uses it
Section titled “Who uses it”Technicians assigned to appointments. Office staff plan work in Veldriq Web. Field never creates work orders.
What it receives from Veldriq
Section titled “What it receives from Veldriq”Assigned appointments (the Field “job”), nested work-order context, customer/site/asset as projected, forms, closeout requirements, and optional inventory. Horizon is about 14 days / a capped job count.
Draft work orders, Unscheduled appointments, and jobs assigned to a colleague never appear.
What technicians can do
Section titled “What technicians can do”- Sign in on Welcome back (email + password, not a PAT).
- Sync, then open Today / Jobs.
- Run execution: Start travel (optional), Arrive, Start work (primary on Assigned), Pause, Resume, Finish my work.
- Fill Forms, capture Evidence and Customer signature, record Findings and used items.
- Expand More details → Closeout → Complete job (appointment Closeout).
- Open Sync → Sync now before assuming the office received it.
What works / does not work
Section titled “What works / does not work”| Works | Does not work | |
|---|---|---|
| Offline | Cached jobs, queued execution, photos, signatures, findings, used items | First login, first workspace download, seeing new office assignments |
| GPS / ETA | Navigate opens the OS maps app | Live van tracking, location on Start travel, computed ETA |
| Sync | Foreground and Sync now | Periodic sync while the app is killed |
| Money | Record used items from van stock | Invoices, purchase orders, office Complete |
Online / offline
Section titled “Online / offline”Supported work is stored locally (Drift SQLite). An outbox sends operations when the app is running and the network is available. A killed app does not periodically sync in the background.
Banner when unreachable: Offline — showing cached data. That is not a logout.
Relationship to office
Section titled “Relationship to office”Laravel is the authority. Local Complete is not final until the server accepts it. Office Complete on the work order is a separate CMS action — not in this app.
If Today is empty after a good login: ask office whether an appointment is assigned to your Active technician. Open Sync → Sync now. Empty Today is usually dispatch, not a login bug.
Next: How it works · Web vs Field.