PutturBus - Real-Time KSRTC Transit App
PutturBus is a modern, high-performance transit application built for the KSRTC Puttur division. It transforms static bus schedules into a live, interactive, and reliable travel companion.
Important
Community Project: This is a non-commercial student initiative. Not affiliated with KSRTC. Read Disclaimer
Documentation Center
We have detailed documentation for every aspect of the project. Choose your path:
| For Users | For Developers |
|---|---|
| User Guide Learn how to search, track, and plan your journey. |
Developer Guide Setup, installation, and contribution guidelines. |
| Features Deep Dive Understand the magic behind our Real-Time Engine. |
Architecture System diagrams, data flow, and tech stack details. |
Quick Start
Get the app running locally in 3 simple steps:
- Clone:
git clone https://github.com/Rajath2005/PutturBus.git - Install:
npm install - Run:
npm run dev
Open http://localhost:3000 to see it in action.
System Overview
PutturBus is built on a modern stack designed for speed and reliability.
graph LR
User(User) -->|Interacts| UI[Next.js App]
UI -->|Queries| Engine[Route Engine]
Engine -->|Filters| Data[(Bus Data)]
Engine -->|Calculates| Physics[Physics Model]
Physics -->|Returns| LiveStatus[Live ETA]
UI -->|Displays| Map[Interactive Map]
User(User) -->|Interacts| UI[Next.js App]
UI -->|Queries| Engine[Route Engine]
Engine -->|Filters| Data[(Bus Data)]
Engine -->|Calculates| Physics[Physics Model]
Physics -->|Returns| LiveStatus[Live ETA]
UI -->|Displays| Map[Interactive Map]
Key Features at a Glance
- Real-Time: Status updates based on actual time (e.g., "Departing in 5 min").
- Physics-Based: Travel times calculated using vehicle speed profiles (Ordinary vs Express).
- Live Map: True-shape route visualization on interactive maps.
- Bilingual: Native support for Kannada and English.
Contributing
We welcome contributions! Please read our Developer Guide to get started.
Built with for KSRTC Puttur