Skip to main content
Vehicles are the foundation of KilomeTracker. Every route, refuel, maintenance record, and expense is linked to a vehicle. This page explains how to add and manage your fleet from the dashboard.

​
Dashboard grid

The dashboard displays your active vehicles as cards. Each card shows the vehicle’s alias, brand, model year, license plates, and key metrics such as total distance traveled. Select a vehicle card to navigate to its detail pages.
Only active vehicles appear in the dashboard grid by default. Deactivated vehicles are hidden but their data is fully preserved.

​
Adding a vehicle

1

Open the add vehicle form

From the dashboard, click Add Vehicle in the top-right area. This opens the vehicle registration form.
2

Enter the vehicle alias

Type a short, unique identifier for the vehicle in the Alias field. The alias is used in all URLs and cannot be changed after creation.Tips for a good alias:
  • Keep it short and memorable (e.g., my-car, truck01, honda-crv)
  • Use only lowercase letters, numbers, and hyphens
  • Avoid spaces and special characters
3

Fill in the vehicle details

Complete the remaining fields:
FieldDescription
MarcaVehicle brand (e.g., Toyota, Ford)
ModeloModel year as a four-digit number (e.g., 2021)
PlatesLicense plate number
Kilometraje inicialStarting odometer reading in kilometers
4

Save the vehicle

Click Save to register the vehicle. It will appear immediately in the dashboard grid.
The vehicle alias cannot be changed after creation. It is used as the unique identifier across all URLs (e.g., /vehicle-stats/my-car) and API calls. Choose it carefully before saving.

​
Vehicle alias

The alias is the permanent, URL-safe identifier for a vehicle. KilomeTracker uses it instead of a database ID to keep URLs readable and stable. For example, a vehicle with alias honda-crv is accessible at:
  • /vehicle-stats/honda-crv — statistics and cost overview
  • /edit-vehicle/honda-crv — edit vehicle details
  • /fuel-analysis/honda-crv — fuel efficiency analysis
Tips for choosing a good alias:
  • Use something descriptive and recognizable, like the make and a number (ford-01).
  • Keep it under 20 characters.
  • Do not use spaces — use hyphens instead.
  • Lowercase only for consistency.

​
Editing a vehicle

You can update a vehicle’s brand, model year, license plates, and starting odometer reading. The alias cannot be changed.
1

Locate the vehicle on the dashboard

Find the vehicle card you want to edit in the dashboard grid.
2

Open the edit form

Click the edit icon on the vehicle card. This navigates to the /edit-vehicle/[alias] page.
3

Update the fields

Modify any of the editable fields: Marca, Modelo, Plates, or Kilometraje inicial.
4

Save your changes

Click Save to apply the changes. The dashboard reflects the update immediately.

​
Deactivating a vehicle

Deactivation is a soft delete — the vehicle is hidden from the dashboard but all associated data (routes, refuels, maintenance records, expenses) is fully preserved and can be queried.
1

Open the edit form

Click the edit icon on the vehicle card in the dashboard.
2

Toggle the active status

Switch the Active toggle to the off position.
3

Save

Click Save. The vehicle disappears from the dashboard grid immediately.
Deactivating a vehicle does not delete any data. All historical routes, refuels, maintenance records, and expenses remain intact. You can reactivate the vehicle at any time via the API (PATCH /api/vehicles/[alias]/reactivate).

Vehicle statistics

View cost of ownership, efficiency metrics, and activity counts for each vehicle.

Tracking routes

Log trips and track distance traveled per vehicle.

Tracking fuel

Record refuels and monitor fuel consumption over time.

Tracking maintenance

Schedule and log service records for each vehicle.

Build docs developers (and LLMs) love

Get started for freeTalk to us