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
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. |
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.
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]
- ⚡ 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.
We welcome contributions! Please read our Developer Guide to get started.
Built with ❤️ for KSRTC Puttur