Getting started
Audience: builders then first technician. Flutter is a client. Laravel is the authority. This product is not the Field PWA.
Screen path for the technician: splash Checking server… → Welcome back → Today. Builders never get a runtime URL screen.
Builder vs technician
Section titled “Builder vs technician”The builder compiles this source, sets the origin with dart-defines, and publishes binaries. The technician sees Today, Jobs, Sync, and Profile. Office users, dispatch, invoicing, Platform Admin, and the Field PWA live in Veldriq Web.
Package name field_mobile is technical only.
Preconditions
Section titled “Preconditions”- Veldriq Web already installed on HTTPS in production.
- You have the Field purchase code (a web code cannot activate this SKU).
- Flutter toolchain for the target OS. There is no demo seed in the ZIP.
First-use path (11 steps)
Section titled “First-use path (11 steps)”- Prepare Veldriq Web — installed, HTTPS in production, cron/queue as you need for office PDFs (Field sync itself is request/foreground).
- Activate Field — Platform Admin → Settings → License & Products. A web code cannot activate Field.
- Technician — staff User + Active technician +
field.workspace.view. See Eligibility. - Compile
API_BASE_URL— origin only (https://fsm.example.com). Rebuild to change it. See API base URL. - Build/install — Android or iOS.
- Sign in on Welcome back → Sign in.
- Sync — land on Today; open Sync if empty.
- Office assigns a non-Draft appointment to that technician.
- Open the job from Today.
- Run execution through Finish my work and Complete job as required.
- Confirm Sync is Up to date before assuming the office received it.
What works / does not work on day one
Section titled “What works / does not work on day one”| Works | Does not work | |
|---|---|---|
| First sign-in | Needs network | Offline-first login |
| Empty Today after login | Expected until office assigns | “Login failed” just because Today is empty |
| Changing the server URL | Rebuild dart-defines | In-app URL field |
If Welcome back never appears: production API_BASE_URL missing or not HTTPS → Invalid configuration. Rebuild. If the title is Unable to reach your company’s server, tap Retry; an existing session is not logged out.
Next: Installation or Working a job.