🚗 ESP32 GPS Car Tracker

GPS car tracker with ESP32 firmware, Node.js backend, and web dashboard.

🌐

Web Flasher

Flash firmware directly from your browser using the ESPHome Web Flasher. No software installation required!

Flash Firmware
📱

Supported Hardware

Optimized for the BerryBase NodeMCU-ESP32 board with reliable SD card support and proven GPS tracking performance.

View Hardware
📖

Complete Documentation

Comprehensive guides for hardware setup, firmware flashing, deployment, and troubleshooting.

Read Docs

🚀 Quick Start

Get your GPS car tracker up and running in minutes:

1. Flash Firmware 2. Hardware Setup 3. Deploy Backend

📚 Documentation

🛠️ Technical Architecture

Tech Stack: ESPHome (firmware) → Express.js + SQLite (backend) → Vanilla HTML/JS (frontend) → Docker + Nginx Proxy Manager (deployment)

Data Flow

  1. ESP32 → Logs GPS to SD card → Uploads CSV via /upload/:filename when WiFi available
  2. User → Uploads receipt photo via /uploadReceipt → Gemini OCR → Geocoded → Stored
  3. Dashboard → Queries /api/fuel and /api/trips → Displays maps and statistics