> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terracetech.co/llms.txt
> Use this file to discover all available pages before exploring further.

# The driver app

> What drivers see on their phone: today's stops, navigation, and proof of delivery.

Drivers run their day from the Terrace phone app. They see their stops in order, navigate to each one, and finish each delivery with photos and notes. The office sees every delivery move as it happens.

Phone app › Trucking

## Driver roles

Terrace has two preset roles for people who drive:

| Role | Who it's for | What they see |
| - | - | - |
| **Driver** | Your own drivers. | Their assigned deliveries, on the mobile app. |
| **External driver** | Brokered and outside truckers. | Only the deliveries assigned to them, on the mobile app. They see the delivery contact's name and phone only while that delivery is active. |

Both roles sign in on the phone app only. If a driver opens Terrace in a web browser, they see **Use the Terrace mobile app**, with a note to open Terrace on their phone to see their deliveries.

> [!NOTE]
>
> Drivers never see prices, totals or order records. They work from a delivery record: where to go, who to call, and what to unload. Invite drivers from [Team](https://docs.terracetech.co/guides/team.md), and assign their work on the [trucking board](https://docs.terracetech.co/guides/trucking.md).

## The Trucking tab

Drivers land on the **Trucking** tab when they sign in. The band at the top counts the day:

Today's dateTrucking

**Stops**Deliveries on today's routes**Done**Delivered so far**Routes**Loads planned for today

### The current delivery

The top card is the delivery in front of the driver, marked **Up now** or **In transit**. It shows the item count, and **Forklift needed** if the customer needs one to unload. It has these actions:

| Action | What it does |
| - | - |
| **Navigate** | Opens directions to the stop. |
| **Call** | Calls the delivery contact. |
| **Start delivery** | Marks the delivery **In transit**. |
| **Complete delivery** | Opens the completion sheet. See [Complete a delivery](#complete-a-delivery). |
| **View delivery** | Shows the full delivery: address, contact, items and instructions. |

Below it, a map card (**Open in Maps**) and the next stops show what's coming up.

> [!TIP]
>
> If an order needs a forklift and none is on the truck, the Trucking tab flags that load: **An order needs a forklift to unload, and none is on board.**

### More for the day

| Link | What it shows |
| - | - |
| **Route map** | Today's stops on a map. |
| **Today's plan** | Every scheduled stop, in order, with stops and completed counts. |
| **Delivery history** | Completed deliveries, with **All**, **Upcoming** and **Delivered** tabs. |

The route and stop order are the ones the office saved in the [route planner](https://docs.terracetech.co/guides/trucking.md).

## Complete a delivery

**1. Open the sheet**

At the stop, press **Complete delivery**.

**2. Add proof of delivery**

Take photos with **Camera**, or pick them from **Gallery**.

**3. Check the quantities**

Each product starts at its planned quantity. If less went off the truck, lower it and pick a reason: **Short**, **Refused** or **Damaged**.

**4. Add a note (optional)**

Use **Delivery notes (optional)** for anything the office should know, like "Left at side gate".

**5. Mark it delivered**

Press **Mark delivered**. The driver sees **Proof of delivery saved**.

When a delivery comes up short, Terrace doesn't lose what's left. The undelivered quantity goes back to the order as **left to schedule**, and planners are notified so they can send it on another delivery. See [Split orders](https://docs.terracetech.co/guides/split-orders.md).

As drivers start and complete deliveries, the order moves to **In Transit** and **Delivered** for everyone in the office. Nobody has to call in.

## Notifications for drivers

Drivers get push notifications on their phone, for example when a delivery is assigned to them. They can choose which ones to get in **More › Settings › Notifications**. See [Notifications](https://docs.terracetech.co/guides/notifications.md).

## Delivering from the web

Owners and office staff usually plan rather than drive. If your farm gives a custom role web access and lets it receive deliveries, that person gets driver screens in the web app, in the narrow-screen menu:

* **Trucking Dashboard** / **My Deliveries**: their orders, active routes and what's completed today.
* **Today's Plan**: stops, miles and minutes, with **Start from Farm**, **Call** and **Navigate**.
* **Active Order**: the delivery in progress, with **Start Route** and **Complete Delivery**.
* **Order History**.

The phone app is the main way to drive with Terrace.

## Related

> [card] [Trucking](https://docs.terracetech.co/guides/trucking.md)
>
> How the office plans loads and routes.

> [card] [Terrace on mobile](https://docs.terracetech.co/guides/mobile.md)
>
> The phone app for everyone else on the farm.

> [card] [Team](https://docs.terracetech.co/guides/team.md)
>
> Invite drivers and external drivers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.