AutoLog is an open-source, full-stack web application built for drivers who want a precise, persistent record of every trip to the gas station. Born from the real-world need to maintain an accurate digital logbook for a Mustang 2000 V6, it has grown into a containerized platform that goes far beyond a simple spreadsheet. AutoLog is especially valuable for drivers in US–Mexico border regions who routinely fill up on both sides of the border: it captures whether you paid in USD or MXN, records the exchange rate applied at the time of the fill-up, and normalizes everything to a single currency (MXN) and a single distance unit (km) so that your efficiency metrics are always apples-to-apples.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/JReyna217/AutoLog/llms.txt
Use this file to discover all available pages before exploring further.
Key Features
Fuel Logging
Record every fill-up with odometer readings, fuel volume, and total cost. Supports both miles/km odometers and gallons/liters inputs, converting and normalizing all values automatically for consistent analytics.
Exchange Rate Management
Maintain a date-stamped catalog of USD/MXN exchange rates. Rates can be entered manually or fetched live from the Banco de México DOF (Diario Oficial de la Federación) API, ensuring that cross-border fill-ups are always priced accurately.
Multi-Vehicle Support
Register multiple vehicles with full specs — make, model, year, cylinders, engine type, fuel type, and color. Each vehicle maintains its own independent fuel log history.
JWT Authentication
Secure, stateless authentication using JSON Web Tokens. Access tokens expire after 15 minutes; refresh tokens extend sessions for up to 7 days without requiring users to re-enter credentials.
Responsive UI
A modern, mobile-friendly interface built with Angular 20 standalone components and PrimeNG controls. The sidebar auto-collapses on mobile viewports for a seamless experience on any screen size.
Docker Deployment
Fully containerized with multi-stage Docker builds cross-compiled for AMD64. Pre-built images are published to Docker Hub, letting you stand up the entire stack with two
docker run commands.Roadmap
AutoLog is under active development. The following features are planned for upcoming releases:
- Maintenance Module — Track preventive and corrective maintenance records including oil changes, brakes, and tires, linked to your odometer readings.
- Smart Notifications — Automated email or push alerts reminding you of upcoming maintenance intervals based on your latest logged mileage.
- User Preferences — Global settings to choose your default display currency and preferred volume metric (Gallons vs. Liters).
- CI/CD Pipeline — Automated testing and deployment workflows via GitHub Actions for every push to the main branch.
Tech Stack
| Layer | Technologies |
|---|---|
| Backend | .NET 10, C# ASP.NET Core Web API |
| Frontend | Angular 20 (Standalone Components), PrimeNG |
| Database | PostgreSQL |
| Infrastructure | Docker, Docker Buildx, Nginx Reverse Proxy, JWT |