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

# Fleet Dashboard

> Fleet Management overview at /fm/fleet/dashboard showing total vehicles, drivers, monthly mileage, fuel cost, expiration alerts, and charts.

This is the Fleet Management overview screen and is available at `/fm/fleet/dashboard`.

## Overview

The Fleet Dashboard renders four stat cards via `useFleetAnalytics`: **Total Vehicles** (with active count), **Total Drivers** (with active count), **Miles This Month**, and **Fuel Cost This Month** (with average MPG). An **Expiration Alerts** card surfaces items expiring within 30 days across registration, insurance, inspection, and driver license categories. Two charts are displayed: a **Vehicle Status** pie/bar chart (`VehicleStatusChart`) and a **Fuel Type Distribution** chart (`FuelTypeChart`). A **Fleet Summary** card shows a compact breakdown by vehicle status, fuel type, monthly mileage, fuel costs, and driver counts. A Quick Actions section is rendered for the `fm` module.

## Who it's for

Requires permission `fm.dashboard.view` (outer `FMViewGuard`).

## Before you start

* Hold `fm.dashboard.view`.
* Vehicles and drivers must be entered for meaningful stats.

## Steps

<Steps>
  <Step title="Open Fleet Dashboard">Navigate to `/fm/fleet/dashboard` via the Fleet Management menu.</Step>
  <Step title="Review stat cards">Check Total Vehicles, Total Drivers, Miles This Month, and Fuel Cost This Month.</Step>
  <Step title="Address expiration alerts">If the Expiration Alerts card is visible, click through to the relevant vehicles or drivers to resolve expiring items.</Step>
  <Step title="Analyze charts">Review the Vehicle Status and Fuel Type Distribution charts.</Step>
  <Step title="Navigate to vehicles">Click the Total Vehicles card or the Vehicles button to go to `/fm/fleet/vehicles`.</Step>
  <Step title="Add a vehicle">Click **Add Vehicle** in the header to navigate to the vehicle form.</Step>
</Steps>

## Key concepts

* **Expiration alerts** — registration, insurance, inspection, and driver license items expiring within 30 days are surfaced.
* **Average MPG** — `averageMpg` from `useFleetAnalytics` (confirm calculation source with SME).
* **Vehicle status** — values from `VEHICLE_STATUS_LABELS` (active, maintenance, retired, disposed).

## Related

<Columns cols={2}>
  <Card title="Facilities & Inventory" icon="warehouse" href="/fm/overview">
    Facilities & Inventory core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/fm.tsx
  * src/cores/fm/pages/FleetDashboardPage.tsx
</Accordion>