New Driver App (v2)¶

Feature Launch Date: March 2026

For: Business Owners, Administrators & Drivers

Overview¶

The Driver App has been completely rebuilt from the ground up. Version 2 is a modern, mobile-first Progressive Web App (PWA) that replaces the original jQuery Mobile-based driver app with a fast, clean interface designed for real-world delivery use -- including full offline support.

Drivers can view routes, mark deliveries, leave notes, take proof-of-delivery photos, and navigate to stops -- all without needing a reliable internet connection. Everything syncs automatically when connectivity returns.

Driver App v2 - Login, Home, Route, and Stop views

What's New in v2¶

Modern, Clean Interface¶

Built with Tailwind CSS for a crisp, professional look
Full dark mode support (Light, Dark, or System auto-detect) -- even Google Maps switches to a dark theme
Bottom navigation bar for easy one-handed use on mobile
Smooth animations (delivery checkmark animation on mark-delivered)

Route Stops with Map Stop - Pending Delivery

Offline-First Architecture¶

This is the biggest upgrade. The v1 app required a constant internet connection. v2 works completely offline:

Mark deliveries offline -- deliveries are saved locally and queued for sync. The stops list updates immediately to show the delivery with a "sync pending" label
Take photos offline -- photos are compressed client-side and stored in the browser's IndexedDB. When back online, they upload automatically to cloud storage (AWS S3)
Leave notes offline -- driver notes are queued and synced alongside delivery data
Automatic sync -- when the device comes back online, all pending actions (deliveries, notes, photos) sync to the server automatically. No manual intervention needed
Offline banner -- a visible indicator shows when the driver is offline, with reassurance that changes will sync automatically

Delivery Notes¶

Drivers can now leave text notes when marking an order as delivered. These notes flow through the entire system:

Customer account page -- notes appear in a blue info banner on the order detail page with the delivery time
Customer notes -- automatically inserted as a customer note (custy_notes) tagged with "driver-app" and the driver's name
Order list -- a yellow sticky-note icon appears next to delivered orders; hover to read the note
Driver tracking page -- note icon in the stops table; click to open the full note in a modal
Admin email alert -- admins subscribed to the "Driver left a note on delivery" notification receive an email with the note content, customer info, and a direct link to the order

Proof-of-Delivery Photos¶

Drivers can take or upload a photo when delivering an order:

Camera integration -- on mobile, the camera opens directly using the rear-facing camera
Client-side compression -- photos are automatically resized and compressed (max 1200px, JPEG quality 0.7) before upload, keeping file sizes small
Cloud storage -- photos upload to AWS S3 with obfuscated filenames, organized by domain. Served through CDN for fast loading
Offline support -- photos taken offline are stored locally and upload automatically when back online
Admin visibility -- photos appear as thumbnails on the order detail page and as camera icons on the order list and driver tracking pages. Click to view full size

Delivered Stop Dark Mode Stop

Undo Delivery¶

Mistakes happen. Drivers can now undo a delivery:

If the order was delivered offline (not yet synced), undo clears the local data and removes the pending sync action
If the order was already synced to the server, undo resets the delivery time and logs the action
Smart notification handling -- if a delivery is undone and re-delivered, SMS/push/email notifications are not sent a second time

Update Notes After Delivery¶

After marking an order as delivered, drivers can go back and update their delivery notes without re-triggering the delivery flow.

Delivery Complete Email¶

A new "Delivery Complete" email template is available. When enabled, customers automatically receive an email when their order is marked as delivered -- just like the existing SMS and push notification options.

Toggle it on/off from the Email Templates page (alongside other system emails like "Delivery Today")
Customize the email content using the standard email template editor
Supports all standard email shortcodes (company, first_name, etc.)
Skips pickup orders automatically

Driver Feedback¶

A built-in feedback form on the Settings page lets drivers send feedback directly to Kiva Logic. Each submission includes full context (company, domain, driver name, current route, order, device info) so issues can be investigated quickly.

Smart Auto-Redirect¶

Once a driver tries v2, they're automatically redirected to it when visiting the old driver app URL. This can be reversed from the Settings page at any time by choosing "Switch to classic driver app."

The driver app now has its own dedicated login page, completely separate from the main website login. This keeps the experience clean and focused for drivers, especially when installed as a PWA.

Login Page

Multiple login methods -- password, magic link (emailed login link), and SMS code verification
Email or username -- drivers can log in with their email address or just a username (e.g., "wayne"), which is helpful for admin accounts that don't use email-based usernames
Magic links stay in the app -- when a driver requests a magic link from the driver app, the emailed link opens directly back into the driver app (not the main website login page)
Logout stays in the app -- logging out returns drivers to the driver app login page, not the main website. This is important for the PWA experience so drivers never leave the app scope

Quick Notes for Deliveries¶

One-tap delivery notes eliminate typing on the go. Instead of manually typing common notes like "Left at front door," drivers can tap a Quick Note button and select from a list of pre-built options:

Left at front door / back door / side door
Handed to customer
Left with neighbor
Left in garage / on porch
No answer - left at door
Gate code needed
Could not deliver - no access
Dog in yard - left at mailbox

Quick Notes Modal

Quick Notes can be stacked -- selecting multiple options appends them together. Drivers can also add custom text after selecting a quick note. The Quick Note button appears everywhere notes are available: when marking a delivery, when updating notes after delivery, and in batch delivery mode.

Active page highlighting -- the bottom navigation bar now highlights which page you're on (Home, All Stops, Current, Settings) with a blue icon and top border
Friendly empty states -- if a driver taps "Current" or "All Stops" before selecting a route, they see a helpful message like "No stop selected -- select a route from the Home page" with a button to go there, instead of a scary error screen
Streamlined stop details -- order details (payment, status, delivery date, order number, phone) are now accessible via a small dropdown arrow next to the customer name, keeping the stop page clean and focused on the delivery actions

Configurable Preferences¶

Settings Page

Theme -- Light, Dark, or System
Step-by-step directions -- toggle turn-by-turn directions on the stop page
Show map -- toggle the map on individual stop pages
Navigation app -- choose Auto-detect, Android (Google Maps), iOS (Apple Maps), or Web (Google Maps web)

Where Delivery Data Appears (Admin)¶

Data	Where it shows	How
Delivery time	Order detail page, order list, driver tracking, customer welcome page	Green checkmark with timestamp
Driver note	Order detail page, order list (hover icon), driver tracking (click icon), customer notes	Yellow sticky-note icon / blue info banner
Delivery photo	Order detail page (thumbnail), order list (camera icon), driver tracking (camera icon)	Blue camera icon / clickable thumbnail
Admin alert	Email to subscribed admins	"Driver left a note on delivery" notification

Enabling the New Driver App¶

The new driver app is available at /kiv/deliverv2/. It has its own login page, so drivers can go directly there without needing to log in through the main website first. A promotion banner on the classic driver app's home page also invites drivers to try it. Once a driver visits v2, they'll be automatically redirected going forward.

To promote it to your drivers:

Share the direct link: https://yourdomain.com/kiv/deliverv2/
Drivers who aren't logged in will see the driver app login page automatically
Or let them discover it through the banner on the classic app

Drivers can switch back to v1 at any time from the v2 Settings page.

Enabling Delivery Complete Emails¶

Go to Email Templates in admin
Find the "Delivery Complete" template
Click the Off button to toggle it On
Customize the subject and body as needed
The email will be sent automatically when orders are marked as delivered

Admin Notification: Driver Notes¶

To receive email alerts when drivers leave notes:

Go to Admin Users and edit your user profile
Under Orders & Fulfillment notifications, enable "Driver left a note on delivery"
This is enabled by default for admin-level users

Installing as a Mobile App (PWA)¶

The new driver app is a Progressive Web App. Drivers can install it to their home screen for a native app experience:

Android -- Chrome will show an "Add to Home Screen" prompt, or use the browser menu
iOS -- In Safari, tap Share > "Add to Home Screen"

Once installed, it launches in full-screen mode without browser chrome, and the service worker enables offline caching of the app shell.

FAQ¶

Do drivers need to do anything to switch?¶

No. They'll see a promotion banner on the old app. Once they tap "Try it now," they'll be redirected to v2 automatically on future visits. Drivers can also go directly to the driver app login page and sign in there.

How do drivers log in to the new app?¶

Drivers can log in using their email/username and password, request a magic link sent to their email, or use SMS code verification (if enabled). The login page is self-contained within the driver app -- drivers never need to visit the main website login.

Can a driver go back to v1?¶

Yes. On the v2 Settings page, there's a "Switch to classic driver app" option that disables the auto-redirect.

What happens if a driver marks a delivery offline and then loses their phone?¶

The delivery data is stored in the browser's IndexedDB. If the browser data is cleared or the phone is lost before syncing, those offline deliveries would need to be re-entered. For critical deliveries, we recommend drivers sync when possible.

Are delivery photos stored securely?¶

Photos are uploaded to AWS S3 with obfuscated filenames (SHA-256 hashed) organized under domain-specific folders. They are not publicly discoverable. Photos are served through a CDN for fast loading.

Does the Delivery Complete email work with v1?¶

The email is triggered by the markDelivered function, which is shared infrastructure. However, the email template toggle and full feature set (notes, photos, undo) are only available in v2.

Can I see which drivers are using v2?¶

When a driver switches to v2, a config setting (driveapp_{userid}) is set. You can check this in the system configuration if needed.