> ## 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.

# Fuel Logs

> View, filter, and log fleet fuel purchases at /fm/fleet/fuel-logs with summary cards for total cost, gallons, and average MPG.

This screen lists fleet fuel log records and is available at `/fm/fleet/fuel-logs`.

## Overview

The Fuel Logs page uses `useFleetFuelLogs` with URL-synced filters: vehicle, driver, fuel type, and date range (today, week, month, 30d, 90d, all — defaulting to 30 days). Page size is 20. Three summary cards display **Total Cost**, **Total Gallons**, and **Avg MPG** for the filtered result set. An optional filter panel exposes vehicle, driver, fuel type, and date range dropdowns. The main data table (desktop) shows: Date, Vehicle, Driver, Fuel Type, Gallons, Cost, \$/Gallon, MPG, Station. A mobile card layout renders the same data in a stacked format. Pagination appears when total pages exceed one. A **Log Fuel** button opens `FleetFuelLogFormDialog`.

## Who it's for

Requires permission `fm.dashboard.view`. Logging fuel may require `fm.fleet.create` — confirm with SME.

## Before you start

* Vehicles and drivers must exist to populate filter dropdowns.

## Steps

<Steps>
  <Step title="Open Fuel Logs">Navigate to `/fm/fleet/fuel-logs` via the Fleet menu.</Step>
  <Step title="Review summary cards">Check Total Cost, Total Gallons, and Avg MPG for the default 30-day period.</Step>
  <Step title="Apply filters">Click **Filters** to expand the filter panel; select a date range, vehicle, driver, or fuel type.</Step>
  <Step title="Browse records">Review the fuel log table (desktop) or cards (mobile).</Step>
  <Step title="Log a fuel purchase">Click **Log Fuel** to open the creation dialog; provide vehicle, fuel type, gallons, total cost, and station details.</Step>
  <Step title="Paginate">Use Previous/Next to navigate large result sets.</Step>
</Steps>

## Key concepts

* **MPG calculated** — `mpg_calculated` stored per fuel log entry; `—` when not available.
* **Price per gallon** — `price_per_gallon` field displayed to 3 decimal places.
* **Date range** — defaults to last 30 days; `all` removes date bounds.

## 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/FleetFuelLogsPage.tsx
</Accordion>