Create a route

Routes are the backbone of field logistics in Surplus. This guide covers creating a new route and configuring its initial stops.

The routes list

The routes section shows all routes in the system, filterable by date, status, and other criteria. Each route card shows its date, stop count, assigned drivers, and current status.

Routes list view (desktop)
Routes list view (mobile)

Creating a route

To create a new route:

  1. Open the routes section and tap Create route
  2. Set the scheduled date and time
  3. Optionally assign a carrier and drivers
  4. Add stops in the desired sequence
Creating a new route (desktop)
Creating a new route (mobile)

Stop types

Each stop you add must be one of:

TypePurpose
CollectionPick up food from a donor location
DistributionDeliver food to a recipient location
LoadPick up staged inventory from a hub
UnloadDrop off items at a hub

Stop ordering

Stops execute in sequence. Consider the logical flow:

  • Collections before distributions (you need food before you can deliver it)
  • Loads before distributions that reference that hub (hub-connected deliveries require the load to happen first)
  • Unloads after collections if food needs to go through a hub before redistribution

Route lifecycle

StatusMeaningTransitions
DraftStill being planned. Needs a scheduled time and one stop; no carrier yet→ Scheduled, → Cancelled
ScheduledPlanned, not started. Needs a carrier, a pickup and a delivery→ Active, → Draft, → Cancelled
ActiveIn progress (driver is on the road)→ Completed, → Cancelled
CompletedAll stops done, vehicle empty→ Active (admin or driver un-complete)
CancelledAbandoned (terminal)None