The driver dashboard is the operational interface for drivers working within a transporter company. Drivers see only the shipments that belong to their linked transporter — not shipments from any other company. This page covers the dashboard overview stats, the shipments view, status update capabilities, and how to post location updates.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/fatelessdev/translogiX/llms.txt
Use this file to discover all available pages before exploring further.
A driver account must be linked to a transporter company via the
transporterId field. If no transporter is linked, the dashboard displays a message asking the driver to contact their administrator. Without this link, no shipment data is accessible.Dashboard overview
When a driver signs in, the dashboard (/driver) displays a personalised welcome and a summary of their transporter company’s shipment activity.
Total Shipments
The total number of shipments ever assigned to the driver’s transporter company.
In Transit
Shipments currently in the
IN_TRANSIT status.Picked Up
Shipments with the
PICKED_UP status — collected but not yet in transit.Delivered
Shipments that have been marked
DELIVERED./driver/shipments.
Shipments view
The shipments page (/driver/shipments) shows all shipments assigned to the driver’s transporter company. Drivers cannot create new shipments — this view is read and update only.
Table columns
| Column | Description |
|---|---|
| Package Code | Unique shipment identifier (e.g. PKG-001). |
| Source | Pickup origin of the shipment. |
| Destination | Delivery destination. |
| Status | Current shipment status with a colour-coded badge and interactive dropdown for allowed transitions. |
| Vehicle | Vehicle number assigned to the shipment, or “Not assigned” if none. |
| Actions | Buttons to add a location update or mark the shipment as delivered. |
Searching shipments
A search bar above the table filters shipments in real time by package code, source location, or destination.Updating shipment status
Drivers can advance a shipment through its lifecycle using the status dropdown in the table. The allowed transitions are the same as for transporter users:DELIVERED and CANCELLED are terminal states — once a shipment reaches either status, no further changes are possible.
Marking a shipment as delivered
When a shipment isIN_TRANSIT, a Mark Delivered button appears in the Actions column. Clicking it opens a confirmation dialog. To confirm, type DELIVER in the text field, then click Mark as Delivered.
When a shipment is marked delivered, its assigned vehicle is automatically set back to AVAILABLE.
Adding location updates
For any shipment that is not yet delivered or cancelled, a Location button appears in the Actions column. Clicking it opens the Add Location Update dialog.Click Location on a shipment row
Find the shipment in the table and click the Location button in the Actions column. This opens the location update form.
Enter a location description
In the Location field, type a human-readable description of the shipment’s current position — for example,
Arrived at Dallas distribution center. This field is required.Optionally add coordinates
You can optionally provide Latitude (−90 to 90) and Longitude (−180 to 180) values for precise geographic tracking. Both fields accept decimal values and are not required.
Data isolation
Drivers are always scoped to their linked transporter. The API atGET /api/driver/shipments enforces this server-side: it reads transporterId from the authenticated session and applies it as a mandatory filter. It is not possible to view or modify shipments belonging to another transporter company.
Status updates (PATCH /api/driver/shipments/[id]/status) and tracking posts (POST /api/driver/shipments/[id]/tracking) perform the same check — if the shipment’s transporterId does not match the driver’s, the request is rejected with a 403 Forbidden response.