Smart Route Management and Scheduling System (SRMSS) for Sri Lankan public transport depots, route planning, timetables, fleet and driver management, maintenance, fuel logging, and role-based schedule approvals.
Repository: https://github.com/MNSBaanu/TransitLK
- Routes — create and manage routes with map integration (Google Maps)
- Schedules — daily timetables, conflict detection, depot approval workflow
- Fleet — buses and drivers, CSV bulk import
- Maintenance & fuel — service logs and consumption tracking
- Reports — analytics and PDF export
- Role-based access — superadministrator through driver portals
- Node.js 18+
- MongoDB (local or Atlas)
- Google Maps API key with Maps JavaScript API and Places API enabled
git clone https://github.com/MNSBaanu/TransitLK.git
cd TransitLK
cd server && npm install
cd ../client && npm installCopy the example files to .env in each folder and set your own values:
server/.env.example→server/.envclient/.env.example→client/.env
| File | Variables |
|---|---|
server/.env |
PORT, MONGO_URI, JWT_SECRET; optional CLIENT_URL, NODE_ENV |
client/.env |
VITE_GOOGLE_MAPS_API_KEY |
See server/.env.example and client/.env.example for descriptions.
# Terminal 1 — API (default http://localhost:5000)
cd server && npm run dev
# Terminal 2 — client (default http://localhost:5173)
cd client && npm run devThe Vite dev server proxies /api to the backend. Verify the API with GET http://localhost:5000/api/health.
The application expects a populated MongoDB database with depot users and reference data. Provision your own database for local development. The UI supports CSV import (sample templates via the API) for vehicles, drivers, routes, users, and maintenance records once an authorised account exists.
| Role | Main modules |
|---|---|
| Superadministrator | Admins, Depots, Analytics |
| Administrator | Dashboard, Routes, Schedules, Fleet, Users, Maintenance, Analytics |
| Transport Scheduler | Routes, Schedules, Analytics |
| Fleet Manager | Fleet & Drivers, Maintenance |
| Depot Manager | Dashboard, Schedules (approve / reject / adjust), Analytics |
| Driver | My trips |
client/ React (Vite) frontend
server/ Express API, Mongoose models, services
render.yaml Optional Render.com deployment for the API
Copyright © 2026 Baanu and Irfa. All rights reserved.
This is an academic project. You may view and run the code for coursework assessment or academic review only. Commercial use, redistribution, modification for publication, and sublicensing are not permitted without written permission from the authors.
Full terms: LICENSE.