⚠️ WARNING: Tracktor is under active development. There may be frequent breaking changes, though we are taking precautions but it is not stable for production use. Please keep regular backups of your data!

<div align="center" style="margin-bottom: 20px;"> <img src="./docs/images/logo.svg" style="height:60px; margin-right: 10px; vertical-align: middle;"/> <h1 style="display:inline; font-size: 2.5rem; vertical-align: middle;">Tracktor</h1> </div> <div align="center">

GitHub License

</div> <p align="center" style="font-size: 1.2rem;"> <b>Tracktor</b> is an open-source web application for <b>comprehensive vehicle management</b>.<br> Easily track <span style="color:#4ade80;">⛽ fuel</span> consumption, <span style="color:#fbbf24;">🛠️ maintenance</span>, <span style="color:#60a5fa;">🛡️ insurance</span>, and <span style="color:#a78bfa;">📄 regulatory documents</span> for all your vehicles in one place. </p> <p align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="./docs/images/dashboard-dark.png" /> <source media="(prefers-color-scheme: light)" srcset="./docs/images/dashboard-light.png" /> <img alt="Dashboard" src="./docs/images/dashboard-light.png" width="90%" style="border-radius: 10px" /> </picture> </p>

✨ Features

🚗 Vehicle Management: Add, edit, and manage multiple vehicles with support for different fuel types.
⛽ Fuel Tracking: Log fuel refills and monitor fuel efficiency over time.
🛠️ Maintenance Log: Record and view maintenance history for each vehicle.
📄 Document Tracking: Track insurance and pollution certificates with renewal dates.
🔔 Reminders: Set and manage reminders for maintenance, renewals, and other vehicle events.
📊 Dashboard: Visualize key metrics, analytics, and upcoming renewals.
🔒 User Authentication: Secure username/password authentication with session management.
🎨 Feature Toggles: Enable or disable specific features based on your needs.

🛠️ Tech Stack

🎨 Frontend: SvelteKit, Tailwind CSS, Svelte 5
🖥️ Backend: SvelteKit Server Routes
🗄️ Database: SQLite with Drizzle ORM
🐳 Deployment: Docker & Docker Compose

🚀 Getting Started

Refer to the installation guide for setup instructions.

📚 Documentation

Installation Guide - Setup instructions for Docker, local development, and Proxmox LXC
Authentication - User authentication and session management
Environment Variables - Configuration options
Feature Toggles - Customizing enabled features
Contributing - Guidelines for contributing

🤝 Contributing

Contributions are welcome! Please read the contributing guidelines before submitting a pull request.

Consider supporting this project by giving it a star ⭐ or sponsoring.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

📊 Repository activity

Activities

⭐ Star History

🤝 Contributors

Tracktor

Install / Use

README