EV Monitor is a full-stack web app for tracking Electric Vehicle charging sessions. Log kWh, costs, location, and duration - and compare your real-world consumption against WLTP ratings using community-contributed data.
Live at ev-monitor.net
| Dashboard | Public Model Pages |
|---|---|
 |
 |
Import Hub - connect SmartCar, Tesla, go-eCharger, OCPP wallboxes, Tronity, Spritmonitor, or upload manually:
- Charging Logs - kWh, costs in EUR, location (geohashed for privacy), duration, date
- Vehicle Management - 68+ brands, 100+ models with battery capacity specs
- Statistics Dashboard - charts, seasonal breakdowns, WLTP delta analysis (Chart.js)
- Interactive Heatmap - visualize charging locations on a map (Leaflet, ~600m precision for private, ~150m for public charging stations)
- WLTP Crowdsourcing - community-contributed real-world range & consumption data per model
- Gamification - earn coins for logging data, adding vehicle specs, and referring users
- Leaderboard - community ranking with optional visibility toggle
- Privacy-First Geohashing - no exact GPS coordinates ever stored
- JWT Authentication - token-based, 7-day sessions
- Email Verification - 24h token with resend + rate limiting
- Password Reset - email-based two-step flow
- OAuth2 - infrastructure ready (Google/Facebook/Apple)
- User Settings - profile, notification preferences, leaderboard visibility
- SmartCar - live sync for 40+ brands via SmartCar API (webhook-driven, no polling)
- Tesla - automatic session sync via Tesla Fleet API (with encrypted token storage)
- Tronity - manual import of Tronity exports
- Spritmonitor - one-click import of existing Spritmonitor history
- go-eCharger - automatic wallbox import API
- OCPP Wallbox - generic OCPP wallbox support (BETA)
- Manual Import - CSV/JSON import with session grouping logic
- Public Upload API - REST API with API keys for wallboxes, scripts, home automation, etc. ...
- Model Overview (
/modelle) - community averages per EV model - Brand Pages (
/modelle/:brand) - all models per brand - Model Detail Pages (
/modelle/:brand/:model) - WLTP vs. real consumption, seasonal data - Model Comparison - side-by-side comparison of multiple models
- Stripe Subscription - infrastructure in place, currently in beta (
PREMIUM_ENABLED=false)
| Framework | Spring Boot 3 |
| Language | Java 21 |
| Build | Gradle (Wrapper) |
| Database | PostgreSQL 15 |
| Security | Spring Security + JWT |
| Architecture | Clean Architecture (domain -> application -> infrastructure) |
| Framework | Vue 3 (Composition API) |
| Build | Vite |
| Language | TypeScript |
| CSS | Tailwind CSS 4 |
| State | Pinia |
| HTTP | Axios (JWT Interceptor) |
| Charts | Chart.js + vue-chartjs |
| Maps | Leaflet + leaflet.heat + markercluster |
| Icons | Heroicons Vue |
- Docker Compose - multi-container setup
- Nginx - reverse proxy + static file serving
- Prerender (
tvanro/prerender-alpine) - server-side rendering for bots/crawlers, in-memory cache (TTL 24h) - Certbot - Let's Encrypt SSL (auto-renewal)
- Hosting - Hetzner Cloud
- Docker + Docker Compose
- Java 21 (for running backend natively)
- Node 20+ + npm (for frontend)
./dev.shStarts the core stack with hot reload:
- PostgreSQL via Docker (
docker-compose.dev.yml) - Mailpit (email testing) via Docker
- Spring Boot backend natively on
http://localhost:8080(dev profile) - Vite frontend dev server on
http://localhost:5173
Logs stream to ./logs/backend.log and ./logs/frontend.log. Stop everything with:
./stop-dev.shTest users (seeded automatically by DevDataSeeder in dev profile):
| Password | Username | |
|---|---|---|
| test1@ev-monitor.net | 123!"§ |
max_e_driver |
| test2@ev-monitor.net | 123!"§ |
anna_ampere |
| test3@ev-monitor.net | 123!"§ |
kurt_kilowatt |
Each user has 2 cars with ~70-80 charging logs spread over 1 year.
Email testing - Mailpit catches all outgoing emails:
- Web UI:
http://localhost:8025 - SMTP:
localhost:1025
# 1. Start DB + Mailpit
docker compose -f docker-compose.dev.yml up -d
# 2. Start Backend (dev profile)
cd backend && SPRING_PROFILES_ACTIVE=dev ./gradlew bootRun
# 3. Start Frontend (hot reload)
cd frontend && npm run devdocker compose -f docker-compose.local.yml up --buildAvailable at http://localhost.
/
├── backend/ # Spring Boot REST API
├── frontend/ # Vue.js PWA
├── nginx/ # Nginx config (reverse proxy)
├── docker-compose.yml # Production orchestration
├── docker-compose.dev.yml # Local dev: DB + Mailpit only
├── docker-compose.local.yml # Full local stack with Nginx
├── dev.sh # One-command local dev startup
├── stop-dev.sh # Stops all local dev processes
├── deploy.sh # Production deployment script
└── init-letsencrypt.sh # First-time SSL certificate setup
backend/src/main/java/com/evmonitor/
├── domain/ # Entities: User, Car, EvLog, CoinLog, VehicleSpec
├── application/ # Services, DTOs, Use Cases
└── infrastructure/ # Spring config, Web, Persistence, Email, Security
frontend/src/views/
├── LandingPageView.vue # / — Public landing page (SEO)
├── PublicModelsListView.vue # /modelle — All models (SEO)
├── PublicBrandView.vue # /modelle/:brand (SEO)
├── PublicModelView.vue # /modelle/:brand/:model (SEO)
├── PublicModelsCompareView.vue # Model comparison
├── LoginView.vue
├── RegisterView.vue
├── ForgotPasswordView.vue
├── ResetPasswordView.vue
├── VerifyEmailView.vue
├── OAuth2RedirectHandler.vue
├── DashboardView.vue # Main dashboard (auth required)
├── LogFormView.vue # Add/edit charging log
├── StatisticsView.vue # Charts & analytics
├── CarManagementView.vue # Vehicle management
├── ImportsView.vue # All imports: SmartCar, Tesla, Spritmonitor, CSV, go-e
├── WallboxSetupView.vue # Wallbox connection management
├── LeaderboardView.vue # Community leaderboard
├── CoinHistoryView.vue # Coin transaction history
├── SettingsView.vue # Account settings
├── UpgradeView.vue # Premium subscription
├── DatenschutzView.vue # DSGVO privacy policy
├── ImpressumView.vue # Legal notice (TMG §5)
├── AGBView.vue # Terms of service
└── NotFoundView.vue # 404
PostgreSQL with Flyway migrations. Migrations live in backend/src/main/resources/db/migration/.
- Docker + Docker Compose on the target server
- A
.envfile (copy from.env.example):
cp .env.example .envRequired environment variables:
DOMAIN=your-domain.com
POSTGRES_USER=evmonitor
POSTGRES_PASSWORD=<strong-password>
POSTGRES_DB=ev_monitor
JWT_SECRET=<64-char-random-string> # openssl rand -base64 64
JWT_EXPIRATION_MS=604800000
ALLOWED_ORIGINS=https://your-domain.com
SPRING_PROFILES_ACTIVE=prod
# Mail (Mailgun/Brevo recommended)
MAIL_HOST=smtp.example.com
MAIL_PORT=587
MAIL_USERNAME=<username>
MAIL_PASSWORD=<password>
MAIL_SMTP_AUTH=true
MAIL_SMTP_STARTTLS=true
APP_MAIL_FROM=noreply@your-domain.com
APP_BASE_URL=https://your-domain.com./deploy.shThe script validates all required env vars, builds multi-stage Docker images, and starts the stack in detached mode.
# Logs
docker compose logs -f backend
docker compose logs -f nginx
# Restart a service
docker compose restart backend
# Manual SSL renewal (auto-renews every 12h via certbot container)
docker compose run --rm --entrypoint certbot certbot renewContributions are welcome. Please open an issue first for larger changes so we can discuss direction before you invest time in a PR.
- Fork the repo
- Create a feature branch (
git checkout -b feat/my-feature) - Run tests before submitting:
cd backend && ./gradlew testandcd frontend && npm run build - Open a PR against
main
For bugs, please include steps to reproduce and the relevant log output.
- Backend README - Architecture, running locally, building
- Frontend README - Tech stack, dev server, building
- Feature Docs - Detailed documentation per feature
The EV Monitor core is open-source under AGPL-3.0. The Wallbox Integration microservice is a separate, closed-source component — the core app works fully without it.