Quick Start
Set up the system and run your first inspection in minutes
Architecture
Understand how the backend, mobile, and desktop apps work together
Admin Guide
Manage fleets, vehicles, assignments, and maintenance from the desktop app
Technician Guide
Use the mobile app to inspect vehicles and track maintenance status
API Reference
Integrate directly with the REST API
Deployment
Deploy to staging or production with Docker and CI/CD
What it does
Fleet & vehicle management
Organize vehicles into named fleets. Track license status, insurance expiry, odometer units, and upload registration and insurance documents.
Technician assignments
Assign technicians to vehicles with business-rule enforcement — one active assignment per vehicle and per technician at any time.
Vehicle inspections
Technicians capture 4 required photos (front, rear, left, right), record mileage and damage notes, and submit reports. A PDF is generated and emailed to the fleet admin automatically.
Maintenance tracking
Track both preventive (scheduled by type and interval) and mandatory maintenance. The system blocks new inspections when mandatory maintenance is overdue.
System components
The platform consists of three packages in a monorepo:| Component | Technology | Used by |
|---|---|---|
| Backend API | Node.js + Express + PostgreSQL | Both apps |
| Mobile app | React Native + Expo | Technicians (and admins on mobile) |
| Desktop app | Electron + React | Fleet administrators |
User roles
There are two roles in the system:- Admin — Full access: manage fleets, vehicles, assignments, technicians, maintenance types, and view all inspections. Admins can also use the mobile app with elevated access.
- Technician — Can view their assigned vehicle, submit inspections, and complete maintenance on their assigned vehicle.
Both roles authenticate with email and password. The system issues a JWT token (valid for 8 hours) used to authorize all subsequent API requests.