πŸš—

MyGarage

Self-hosted vehicle maintenance tracking application

What is MyGarage?

MyGarage is a self-hosted vehicle maintenance tracker. Add your cars, log services, track fuel economy, and get automated notifications when maintenance is due. It decodes VINs automatically, checks for recalls, and keeps all your receipts and documents in one place.

The app supports multiple users with OIDC/SSO integration (works with Rauthy, Keycloak, etc.) so your whole household can manage their vehicles. Garage analytics show spending trends across all vehicles, while individual dashboards break down costs per car.

It goes beyond cars: hour-metered gear like ATVs, side-by-sides and generators gets the same treatment as distance-tracked vehicles, a light supplies inventory folds consumable costs into service visits, and LiveLink pulls real-time OBD2 telemetry and GPS trips from a WiCAN device or the Torque Pro app. The interface is fully translatable and ships in seven languages.

Everything runs on your own hardwareβ€”no subscriptions, no cloud accounts, your data stays yours. Take a photo of a receipt and OCR extracts the details. Export reports as PDF or CSV when you need them.

View on GitHub

Technology Stack

Backend

  • β†’ Python 3.14+ with FastAPI 0.141.1 and Granian 2.8.1 ASGI server
  • β†’ SQLAlchemy 2.0.51 + SQLite (WAL mode) via aiosqlite 0.22.1 or PostgreSQL via asyncpg 0.31.0
  • β†’ pandas 3.0.5 for CSV import/export and analytics aggregation
  • β†’ Pydantic 2.13.4 for data validation and settings management
  • β†’ JWT auth with Argon2id hashing, OIDC/SSO with PKCE S256, and joserfc 1.7.4 for token/JWKS verification
  • β†’ NHTSA API for VIN decoding and recall checks (httpx 0.28.1)
  • β†’ Tesseract OCR for receipt scanning (PyMuPDF 1.28.0)
  • β†’ ReportLab 5.0.0 for PDF generation and matplotlib 3.11.1 for analytics charts
  • β†’ Multi-service notifications via aiosmtplib 5.1.2 for email delivery
  • β†’ APScheduler 3.11.3 for background jobs (maintenance alerts, recall checks, milestones)
  • β†’ LiveLink telemetry via aiomqtt 2.5.1 for WiCAN OBD2 devices, plus HTTP ingest from the Torque Pro Android app
  • β†’ Rich 15.0+ for pretty container log formatting (opt-in via MYGARAGE_LOG_PRETTY)

Frontend

  • β†’ React 19.2.7 + TypeScript 6.0.3 with Bun runtime and Vite 8.1.5 bundler
  • β†’ Tailwind CSS 4.3.3 with a shared design system, six selectable accent colours, and light/dark mode
  • β†’ React Router 7.18.1 for client-side navigation
  • β†’ TanStack Query 5.101.2 for server state management with automatic cache invalidation
  • β†’ Recharts 3.9.2 for interactive analytics charts
  • β†’ Schedule-X 4.6.1 for calendar UI β€” native TypeScript with React 19 support
  • β†’ date-fns 4.4.0 for date manipulation and formatting
  • β†’ Zod 4.4.3 + React Hook Form 7.82.0 for form validation
  • β†’ Lucide React 1.25.0 iconography and Sonner 2.0.7 for toasts
  • β†’ react-i18next 17.0.10 + i18next 26.3.6 for multi-language support across seven languages
  • β†’ OpenAPI-generated TypeScript types via openapi-typescript, eliminating manual type drift

Project Statistics

~239,400
Total Lines of Code
~133,800
Python Backend
~105,700
TypeScript Frontend
17
Interactive Pages