⚠️ WARNING: Tracktor is under very active development. There may be frequent breaking changes, and it is not stable for production use. Please keep regular backups of your data!

Tracktor

Tracktor is an open-source web application for comprehensive vehicle management.
Easily track ⛽ fuel consumption, 🛠️ maintenance, 🛡️ insurance, and 📄 regulatory documents for all your vehicles in one place.

• 🚗 Vehicle Management: Add, edit, and manage multiple vehicles.
• ⛽ 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, pollution certificates, and other important documents.
• 📊 Dashboard: Visualize key metrics and upcoming renewals.
• 🔒 User Authentication: Secure access to your data.

• 🎨 Frontend: SvelteKit, Tailwind CSS
• 🖥️ Backend: Node.js, Express.js
• 🗄️ Database: SQLite
• 📚 Documentation: VitePress
• 🐳 Containerization: Docker & Docker Compose

• 🟢 Node.js (v18 or higher)
• 📦 npm
• 🐳 Docker & Docker Compose (for containerized setup)

1. Clone the repository:

   git clone https://github.com/your-username/tracktor.git
   cd tracktor

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

4. Open your browser: Navigate to http://localhost:5173 for the frontend.

1. Build and start all services:

   docker-compose up --build

2. Access the app:
   • 🚜 Main App: http://localhost:3000
   • 📚 Docs: http://localhost:5173

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

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