Key capabilities
Vehicles
Register multiple vehicles by alias, brand, model year, license plates, and initial mileage. View full stats and lifetime history per vehicle.
Routes
Log every trip with distance (km) and date. Total mileage updates automatically and feeds into cost-per-km calculations.
Fuel
Record refuels with fuel type, amount spent, and gallons. KilomeTracker calculates km/liter, km/gallon, and cost per km automatically.
Maintenance
Keep a complete service log — oil changes, tire rotations, brake jobs, inspections, and more. Set next-service reminders by date or mileage.
Expenses
Track insurance, taxes, registration, parking, tolls, fines, financing, and any other vehicle costs. Mark items as tax-deductible.
Admin
Admin users can manage accounts, assign roles, deactivate users, and reactivate them as needed.
How it works
KilomeTracker is built around a simple workflow. Start with a vehicle and build up its history over time:Add a vehicle
Register your vehicle with a unique alias, brand (
marca), model year (modelo), license plates (plates), and initial mileage (kilometrajeInicial). The alias becomes the identifier used throughout every URL and record.Log trips
Every time you drive, record a route with the distance in kilometers and the date. Your vehicle’s total mileage (
kilometrajeTotal) grows with each entry.Track fuel
After each refuel, log the fuel type, amount spent, and gallons filled. KilomeTracker aggregates this data into efficiency metrics and charts.
Monitor maintenance
Add maintenance records after every service visit. Schedule the next service by date or mileage and receive upcoming-maintenance reminders in the dashboard.
Role-based access
KilomeTracker uses role-based access control with three user-facing roles:| Role | Permissions |
|---|---|
read | View all vehicle data, history, and reports. Cannot create or edit records. |
write | Full access to create, edit, and delete vehicles, routes, refuels, maintenance, and expenses. |
admin | All write permissions plus access to the user management panel — create accounts, change roles, deactivate and reactivate users. |
root role exists in the backend but is not manageable from the UI.
Security and authentication
KilomeTracker uses JWT tokens for authentication. Tokens are stored in HTTP-only cookies and are never exposed to client-side JavaScript.The frontend uses a BFF (Backend for Frontend) proxy pattern. Every API call from the browser goes to a Next.js route handler under
/api/, which reads the JWT from the HTTP-only cookie and forwards the request to the backend with an Authorization: Bearer header. This keeps auth tokens completely out of reach of browser JavaScript, protecting against XSS token theft.