Driver app
Route
The published day plan: map, ordered legs, navigate, recalculate, and tell dispatch.
Route is only as good as what dispatch published. Draft plans stay invisible here — if nothing is published, Jobs still holds your assignments.
This screen is the field execution surface: every stop type, live progress, navigation, and exception path.
-
1 How you land on Route
Several paths open the same tab so drivers never hunt for the plan.
- Route tab
- Bottom navigation destination.
- Push: route published / updated / withdrawn
- Notification deep-links open Route immediately.
- Jobs → Today's Route
- Banner jumps here with stop/km/duration summary.
Route tab · Desktop
Route tab · iPhone -
2 Date strip
A seven-day strip lets you inspect today and nearby published days.
- Today / Tmrw / weekday chips
- Jump between calendar days.
- Published dot
- Green/white indicator when that day has a published or in-progress route.
Date strip · Desktop
Date strip · iPhone -
3 Empty & unpublished
If dispatch has not sent a plan, Route refuses to invent one.
- Loading
- Spinner while the plan document loads.
- No route published for…
- Empty title for today, tomorrow, or a named weekday.
- Subcopy
- “Dispatch hasn’t published a route plan yet. Your assigned jobs are on the Jobs tab.”
- Draft plans
- Unpublished / draft office plans do not appear here.
Empty / unpublished · Desktop
Empty / unpublished · iPhone -
4 Summary bar
When a route exists, the header tracks remaining work and dispatch edits.
- N stop(s) remaining / Route complete
- Primary progress title.
- done of total · legs · km · done by ETA
- Customer-stop progress, leg counts, distance, and projected finish.
- Updated by dispatch · time
- Shown after a republish so you know the list changed.
- Progress ring
- Visual done/total for customer stops.
- Recalculate
- Today only, when ≥2 customer stops remain — reorders remaining work from your location.
- Tell dispatch
- Opens the exception form without failing a job.
Summary bar · Desktop
Summary bar · iPhone -
5 Map
The map mirrors the stop list so you can orient geographically.
- Route polyline
- Planned path across the day.
- Numbered markers
- Colored by state; current stop is emphasized.
- Tap marker
- Selects the matching stop in the list.
- My location + zoom
- Standard map chrome.
- Layout
- Phone: map above list. Wide (≥900): list left, map right.
Route map · Desktop
Route map · iPhone -
6 Stop cards & types
Every leg appears — yard, customer, dump, and return — not only deliveries.
- Sequence circle
- Number while pending; ✓ when done; redo icon when skipped.
- NEXT badge
- Marks the current executable stop.
- Load at yard
- Yard load before customer work.
- Deliver bin
- Empty bin drop at the customer.
- Pickup full bin
- Remove a full bin from site.
- Deploy empty (swap) / Pickup full (swap)
- Swap visit as two linked legs.
- Dump
- Tip full material at a dump site.
- Return to yard
- End-of-day return.
- Title line
- `{legLabel} · {orderNumber}` when an order is attached.
- Address
- Up to two lines of location text.
- ETA / N min drive
- Timing chips on the card.
- Skipped styling
- Strikethrough + muted colors for failed/cancelled legs.
- Nav button
- On the current stop — opens turn-by-turn navigation.
- Tap card
- Order legs → Job Detail; non-order legs → MapView for that stop.
Stop cards · Desktop
Stop cards · iPhone -
7 Navigate
Navigation is optimized for the current stop, with graceful fallbacks.
- In-app Navigation
- Native map experience when available.
- Web navigate.html
- Browser fallback for web builds.
- MapViewScreen
- Used for non-order stops or when the order cannot be opened.
- Straight-line note
- Shown when a full routed path is unavailable.
- No coordinates
- Snackbars when destination geometry is missing.
Navigate · Desktop
Navigate · iPhone -
8 Tell dispatch
Flag a problem without marking the customer job failed.
- AppBar: Tell dispatch
- Exception screen title.
- Can't access the site
- Access / gate / blockage.
- Customer not ready
- Site not prepared for the visit.
- Truck issue
- Equipment problem on your unit.
- I'm running late
- Timing / ETA risk.
- Note for dispatch (optional)
- Free-text context.
- Send to dispatch
- Notifies the office; snackbar confirms.
Tell dispatch · Desktop
Tell dispatch · iPhone -
9 Recalculate
Re-sequence remaining customer stops from where you are now.
- Route updated / Route unchanged
- Result screen titles.
- Would not fit
- Lists order numbers that could not be kept in the window.
- Your day now / unchanged
- Shows Deliver / Swap / Pick up lines with ETAs.
- Back to route / OK
- Return CTAs.
- Error snackbar
- “Could not recalculate: …” on failure.
Recalculate · Desktop
Recalculate · iPhone