YouHao

Project Overview

Fuel Track organizes refueling, mileage, and expenses into genuinely useful driving data. It does not rely on centralized accounts: both Web and Android store data locally, and sync to your own WebDAV space when cross-device access is needed. The project is in early development (0.1.x).

Key Features

• See real fuel consumption: Calculated based on consecutive full-tank intervals, supports partial refueling, no need to estimate dashboard data
• Data belongs to you: Web uses SQLite WASM, Android uses native SQLite; fully usable offline
• Sync without full database overwrite: Merges by record update time, combined with UUID, soft delete, and ETag conflict retry
• One experience, multiple platforms: Vue 3 interface serves desktop Web, mobile Web, and Android via Capacitor
• Multi-vehicle independent ledgers, full-tank interval fuel consumption, monthly and cumulative costs, fuel consumption trend charts
• WebDAV bidirectional merge, JSON full backup, CSV report export
• Responsive desktop sidebar, mobile bottom navigation

Target Audience

• Users who need to track vehicle fuel consumption
• Users with multiple vehicles needing independent ledgers
• Users who need to sync fuel data across devices
• Web / Android users

Quick Start

1. Requires Node.js 20+ and npm
2. Clone the repository: git clone https://github.com/GayFirends/YouHao.git
3. Install dependencies: npm install
4. Run development: npm run dev
5. Android build requires Java 21

Core Advantages

• Local-first, data belongs to you
• Merges by record update time without full database overwrite
• WebDAV sync to Jianguoyun, Nextcloud, Synology, etc.
• One codebase serves both Web and Android

System Requirements

• OS: Web / Android
• Additional dependencies: Node.js 20+, npm; Java 21 for Android build