Vehicles

This screen lists all fleet vehicles and is available at /fm/fleet/vehicles.

​

Overview

The Fleet Vehicles page uses useFleetVehicles to load a paginated list of vehicles (page size 20). Filters include: text search (VIN, plate, make, model), Status (from VEHICLE_STATUSES), Fuel Type (from FUEL_TYPES), and Site (fetched from pf_sites). URL query parameters sync with filter state and page number. The data table shows: Vehicle (year/make/model with vehicle number), VIN (truncated, last 6), Plate, Status badge, Odometer, Assigned Driver, and Site. An Add Vehicle button opens FleetVehicleFormDialog. Pagination controls appear when total pages exceed one.

​

Who it’s for

Requires permission fm.dashboard.view. Adding vehicles requires fm.fleet.create.

​

Before you start

• Hold fm.dashboard.view.
• Sites must be configured for the site filter to populate.

​

Finding a vehicle

1. Navigate to /fm/fleet/vehicles via the Fleet Dashboard or sidebar.
2. Use the search bar and Status, Fuel Type, and Site dropdowns.
3. Click Add Vehicle to open the form dialog; provide VIN, make, model, year, fuel type, and other required fields.
4. Click any vehicle row to navigate to /fm/fleet/vehicles/:id.
5. Use Previous/Next buttons to page through large vehicle lists.

• VIN — Vehicle Identification Number, displayed truncated (last 6 characters) in the table.
• Vehicle status — values from VEHICLE_STATUS_LABELS: active, maintenance, retired, disposed.
• Fuel type — values from FUEL_TYPE_LABELS (from FUEL_TYPES array).

​

Viewing a vehicle

The Vehicle Detail page (/fm/fleet/vehicles/:id) loads a vehicle via useFleetVehicleDetail. The header shows year/make/model, status badge, and vehicle number. The right side has action buttons: Assign/Reassign Driver, Change Status, and Edit. A two-column grid holds: a Vehicle Details card (VIN, plate, color, fuel type, odometer), a Registration & Insurance card (registration expiration, insurance expiration, inspection expiration — each in warning color if within 30 days), and a tabbed History card with four tabs: Trips (date, type, destination, miles), Fuel (date, gallons, station, cost, MPG), Mileage (odometer readings), and Maintenance (schedules with next due date/odometer and overdue badge). A sidebar contains: Assignment (site, assigned driver), Odometer (current reading with Record Reading button), Quick Actions (Log Trip, Log Fuel), and conditional Expiration Alerts. Requires fm.dashboard.view. Driver assignment requires fm.fleet.edit; confirm with SME. Before you start: the vehicle must exist and not have been deleted.

1. From the Vehicles list, click any row to navigate to /fm/fleet/vehicles/:id.
2. Check VIN, plate, color, fuel type, and odometer.
3. Review expiration dates; warnings appear 30 days before expiry.
4. Click Assign Driver (or Reassign) to open AssignDriverDialog.
5. Click Change Status to open ChangeVehicleStatusDialog.
6. In the sidebar Odometer card, click Record Reading to open RecordMileageDialog.
7. Click Log Trip in the Quick Actions sidebar card to open FleetTripFormDialog.
8. Click Log Fuel in the Quick Actions sidebar card to open FleetFuelLogFormDialog.
9. Use the Trips, Fuel, Mileage, and Maintenance tabs to audit vehicle activity.

• Expiration alerts — registration, insurance, and inspection expirations within 30 days surface a warning sidebar card.
• Maintenance schedules — from vehicle.maintenance_schedules; overdue schedules show a destructive badge.
• MPG calculated — computed and stored per fuel log entry.

​

Viewing a driver

The Driver Detail page (/fm/fleet/drivers/:id) loads a driver via useFleetDriverDetail. The header shows first/last name, active/inactive badge, CDL badge (if applicable), and email. Action buttons include Activate/Deactivate toggle and Edit. A two-column grid holds: Contact Information (email with mailto link, phone with tel link, linked user profile with avatar), License & CDL (license number in monospace, state, class, expiration — with warning/destructive color based on days remaining; CDL endorsements displayed as CDL_ENDORSEMENT_LABELS badge tooltips and CDL expiration), and tabbed History (Assigned Vehicles list linked to vehicle detail pages, Recent Trips with type/destination/miles). A sidebar contains: Status card with Activate/Deactivate button, conditional Expiration Alerts (license and CDL), Notes, and Quick Stats (assigned vehicle and trip counts). A Delete button opens a destructive confirmation dialog. Requires fm.dashboard.view. Deactivation and deletion require fm.fleet.edit or fm.fleet.delete — confirm with SME. Before you start: the driver must exist and not have been soft-deleted.

1. Navigate to /fm/fleet/drivers/:id (typically by clicking a driver in the Fleet Dashboard or from a vehicle’s assigned driver).
2. Check email, phone, and linked user profile.
3. Check license number, state, class, and expiration; CDL endorsements and expiration if applicable.
4. If the Expiration Alerts sidebar card is visible, license or CDL is expiring within 30 days.
5. Use the Deactivate/Activate button to toggle the driver’s active status.
6. Click Edit to open FleetDriverFormDialog and update driver information.
7. Click Delete and confirm the destructive dialog to soft-delete the driver. The driver is unassigned from all vehicles.

• CDL endorsements — labels from CDL_ENDORSEMENT_LABELS, displayed as tooltip badges.
• Expiration alerts — license and CDL expiration within 30 days; expired dates shown in destructive color.
• Soft delete — the softDeleteDriver mutation; confirm whether data is preserved (confirm with SME).

​

Related

Documentation sources

• src/routes/fm.tsx
• src/cores/fm/pages/FleetVehiclesPage.tsx
• src/cores/fm/pages/FleetVehicleDetailPage.tsx
• src/cores/fm/pages/FleetDriverDetailPage.tsx