Driver Mobile App

The NextRoute mobile app (iOS and Android) is the driver's primary tool for executing routes in the field. It provides route navigation, stop completion, photo capture, skip workflows, and real-time GPS tracking.

Route View

When a driver opens the app, they see their dispatched routes for the day:

• Route list: All routes assigned to them, with status badges
• Stop count: Number of stops and completion progress
• Map view: All stops plotted on a map with route lines

Tapping a route opens the route detail view showing each stop in sequence with:

• Customer name and address
• Service plan name
• Bin count and location notes
• Estimated arrival time
• Navigation button (opens Apple Maps or Google Maps)

Starting a Route

Tap Start Route to begin:

1. Route status changes to in_progress
2. GPS tracking activates — location pings are sent to the server
3. The first stop is highlighted
4. Live Activity begins (iOS) showing real-time progress on the lock screen

Stop Completion

At each stop, the driver:

1. Arrives — tap to mark arrival (or auto-detected via GPS proximity)
2. Takes before photos (optional) — camera opens for pre-service documentation
3. Completes service — performs the work
4. Takes after photos (optional) — camera opens for post-service documentation
5. Marks complete — tap the completion button

The stop status progresses: pending → en_route → arrived → in_progress → completed

Each completed stop records:

• arrived_at — arrival timestamp
• completed_at — completion timestamp
• photo_urls_json — array of photo URLs (stored in R2)

Skip Workflow

If a stop cannot be completed, the driver taps Skip and selects:

1. Skip category (required):

   • no_access — cannot reach the property
   • weather — weather prevents service
   • operational — equipment or operational issue
   • customer_request — customer asked to skip

2. Reason (optional): Free-text explanation

3. The system applies the configured skip policy based on the category and the customer's service frequency:

   • May add a revisit to today's route
   • May reschedule to the next available date
   • May simply skip with no follow-up

The driver sees a confirmation indicating what action was taken.

GPS Tracking

While a route is in progress, the app sends GPS pings to the server at regular intervals:

GPS data powers:

• Live map in the web dashboard
• ETA estimates for upcoming stops
• Arrival detection at stop locations
• Historical route replay

Live Activity (iOS)

On iOS, a Live Activity widget appears on the lock screen and Dynamic Island showing:

• Current stop number / total stops
• Next customer name and address
• Route completion progress
• Elapsed time

This lets drivers glance at route progress without unlocking their phone.

Checklist Support

If your business uses checklists (pre-route, post-route, or per-stop), they appear in the mobile app at the appropriate time:

• Pre-route checklist: Shown when starting the route (e.g., vehicle inspection)
• Post-route checklist: Shown when completing the route
• Per-stop checklist: Shown at each stop (e.g., service verification items)

Offline Support

The app caches route data for limited offline use. Stop completions and photos are queued locally and synced when connectivity is restored.

Related

• Photo Proof — before/after photo documentation
• Live Tracking — real-time driver location monitoring
• Skip & Reschedule — skip policies and actions