📘 User Guide
Fuel Efficiency & Maintenance Tracker — Version B-01
🚀 Quick Start Guide
- Start by importing your previous JSON file if you already have one (click "Import Data")
- Add either fuel logs or service records during your session
- View real-time statistics on the dashboard
- Export JSON before leaving — your data only exists in your browser
- Next session: import the same file first before adding new entries
- Use the exported file for spreadsheet analysis or backup
💡 Pro Tip: Always export your JSON after each session. Without export, clearing browser data will permanently delete your history.
⛽ Fuel Logs
- Track every refueling event with date, odometer, liters, and cost
- Efficiency (km/L) is calculated automatically between fill-ups
- Total fuel consumed and fuel cost are displayed in stats
- Enter costs in your local currency — no symbol needed
🔧 Service History
- Log all maintenance: oil changes, repairs, part replacements
- Track service costs for total cost of ownership analysis
- "Since Last Service" shows distance since most recent service
- If you see a warning icon (⚠️), it means service was logged at a higher odometer than current reading
✏️ Edit or Delete
- Click the ✏️ icon to edit any existing entry
- Click the 🗑️ icon to delete an entry (confirmation required)
- Changes are saved immediately to localStorage
📊 Advanced Analysis
- Export your data as JSON
- Use the file with spreadsheet software (Excel, Google Sheets, or any data analysis tool)
- Calculate trends, visualize costs, or track long-term efficiency
🌓 Dark / Light Mode
- Click the theme toggle button in the top-right corner
- Your preference is saved automatically for next visits
📱 PWA Installation
- Desktop (Chrome/Edge): Click the install icon in the address bar
- Mobile (iOS): Share menu → "Add to Home Screen"
- Mobile (Android): Menu → "Install App"
- Once installed, the app works offline
🔒 Privacy Commitment
- Zero telemetry — no data ever leaves your browser
- No account required — use immediately
- No tracking cookies — we don't track you
- You control your data — export, import, or delete anytime
❓ Frequently Asked Questions
What happens if I clear my browser data?
All your fuel and service logs will be permanently deleted. That's why we strongly recommend exporting your JSON file regularly.
Can I use this on multiple devices?
Yes! Export the JSON from one device and import it on another. Your data follows you.
Is there a cloud backup?
No — by design, this app is zero-telemetry. All data stays on your device. You control backups via the Export feature.
What currency should I use?
Enter all costs in your local currency. The app doesn't assume any specific currency symbol.
Why does "Since Last Service" show a warning icon?
It appears when a service was logged at a higher odometer than your current reading — meaning you may have missed logging some fuel entries after that service. The app still shows the absolute distance to avoid confusion.
Is my data shared with anyone?
Never. This app has zero telemetry. No data ever leaves your browser. No analytics, no tracking, no servers.
← Back to Application