Omnifleet User Manual

This manual describes routes and features verified against the Omnifleet dashboard application build (TanStack Router routes, DashboardRouteGuard / route-permissions, and API-backed screens). Screens backed only by local fixtures or incomplete placeholders are intentionally omitted here.

Table of contents

Getting started

• Authentication & invitations — Login, password reset, invitation acceptance.
• Permissions and access — Route guards, organization vs group scope, access denied messaging.
• Groups — Organization and group switching.
• How to Use Forms — Validation patterns and common fixes.

Dashboard & operations

• Dashboard home — Overview widgets and live map snapshot.
• Alerts — Fleet alert inbox and alert detail workflow.
• Fuel monitoring — Pointers into the fuel & alerts module (production API flows).

Fleet & tracking (module)

• Fleet & tracking — module home — Live tracker, vehicles, devices, troubleshooting.
• Live tracker — Live map and vehicle list.
• Vehicles — List, create/edit, detail, history.
• Devices — List, create/edit, general info, sensors, raw data.

Fuel & alerts (module)

• Fuel monitoring and fleet alerts — module home — Fuel events, consumption, alerts inbox.

Maintenance & work orders (module)

• Maintenance & work orders — module home — Issues, incidents, work orders, service tasks.

People, reporting & compliance (module)

• People, reporting & compliance — module home — Drivers, vendors, users, roles, reports, audit logs, notifications.

General settings (module)

• General settings — module home — Geofences, addresses, route fences, integrations.

People & administration (console topics)

• Drivers & vendors — Actor-facing driver tools and vendor catalog.
• User management & invitations — Administrative roster and invitation lifecycle.
• Roles & permissions (admin UI) — IAM role catalog maintenance.

Profile, notifications & legacy settings hub

• Settings — Short hub for geofences and address settings (see module for full detail).
• Notification preferences — Organization notification toggles and recipients.
• Profile & security settings — Personal profile and password (/dashboard/settings).

Governance & analytics

• Reports — Template-based analytical exports.
• Audit logs — Organization audit trail listing.

Quick orientation

1. Sign in via Authentication.
2. Pick organization and group using Groups.
3. Open sidebar sections described above; if an entry is missing or blocked, read Permissions.