Skip to main content
The Fleet Admin desktop app is an Electron + React application that gives administrators a single control plane for the entire fleet operation. From here you can manage fleet structure, vehicle inventory, maintenance schedules, and inspect field reports without leaving one window.

Roles that can access the app

Admin

Full access to all modules. Can create and delete fleets and vehicles, assign maintenance, manage assignments, and view all reports.

Technician

Read-only access to relevant views. Technicians primarily interact with the mobile app; their records are visible in the desktop app by admins.

Launching the app

1

Install dependencies

From the repository root, install all workspace packages:
yarn install
2

Start the desktop app in development mode

Run the Electron + React dev server:
yarn workspace desktop dev
The app window opens automatically once the renderer has compiled.

Logging in

The backend seeds a default admin account on first run. Use these credentials on the login screen:
FieldValue
Email[email protected]
Passwordchangeme123
Enter your email and password, then click Entrar al centro de operaciones to access the main shell. If your organisation uses a different account, enter those credentials instead.
The login form pre-fills the demo credentials for convenience in development environments. Clear the fields before entering production credentials.
After logging in, the left sidebar provides access to all five modules. Each button shows a short label and a contextual sub-label describing the section.

Dashboard

A high-level summary of the current operational state. Shows counts, system signals, and recent inspection activity. This is the landing page after login.

Fleets

Create, edit, and delete fleet groups. Each fleet acts as an organisational container for vehicles.

Vehicles

Register and manage the vehicle inventory. Track license status, odometer unit, insurance expiry, and uploaded documents per vehicle.

Maintenance

Configure maintenance type categories and assign preventive or mandatory maintenance schedules to individual vehicles.

Reports

View the full history of inspection reports generated by technicians in the field. Download PDF evidence where available.

Dashboard summary

The dashboard loads automatically after login and displays four metric cards:
MetricWhat it counts
Active fleetsTotal number of fleet records, with a sub-count of those that have at least one vehicle assigned
Vehicles under controlTotal vehicle count, with a sub-count of vehicles whose license status is expired
Configured typesTotal number of maintenance type categories defined in the system
Issued reportsTotal inspection reports, with a sub-count that have an exportable PDF attached
Below the metrics, the dashboard shows:
  • Recent activity — The three most recent inspection reports, including the vehicle ID, technician ID, and recorded mileage.
  • System signals — Quick-read indicators for fleet coverage percentage, valid vs. total licences, and exportable vs. total reports.
  • Focus of the day — A contextual alert that highlights the most pressing operational issue: expired licences, empty fleets, or a clean bill of health.
Use the Refrescar datos button at the bottom of the sidebar to pull the latest data from the backend without restarting the app.

Build docs developers (and LLMs) love