Skip to content

An open-source initiative to revolutionize public transport with real-time bus tracking.

License

Notifications You must be signed in to change notification settings

LismaxB/Ceylon-Public-Transit

🌍 Ceylon Public Transit - Open Source Bus Location Tracker 🚍

Welcome to Ceylon Public Transit, an open-source initiative aimed at revolutionizing public transport for the people of Sri Lanka! Our project aims to provide real-time bus tracking, making your daily commute smoother and more efficient, we're building the future of public transit with the help of the open-source community. 🌟


📋 Project Overview

🌟 Features

  • Real-Time Bus Tracking: View live locations of buses as they travel across their routes.
  • Driver App: Allows bus drivers to start and end trips and share real-time locations with passengers.
  • Core Client App: Enables users to track available buses, view routes, and see bus stop details.
  • Web Application: Displays bus locations on a map, allowing passengers to see active routes and monitor buses.

🚀 Project Progress

Driver App:

  • Core Version Complete: Drivers can log trips with Start and End buttons.
  • Sends bus location every 5 seconds while a trip is active.
  • Simple and lightweight interface designed for ease of use.

Client App:

  • Core Version Complete: Displays real-time bus locations on a map.
  • Currently showcases the first route from the database.
  • Mobile-friendly and accessible for passengers.

Web Application:

  • Core Version Complete: Shows all available bus locations and routes on an interactive map.
  • Displays the first sample route for now, with plans for future expansion.

🎯 Future Plans

  • Dynamic Route Management: Implement flexible routes for buses going in both directions (e.g., A to B, B to A).
  • Real-Time Traffic Integration: Adjust routes and bus ETAs based on live traffic conditions.
  • Comprehensive User Experience: Add notifications for upcoming bus arrivals and delays.
  • Enhanced Driver Experience: Allow drivers to input bus capacity and other relevant data.

🛠 Tech Stack

  • Frontend: React (for web app), React Native (for mobile apps)
  • Backend: Supabase (for real-time database and API management)
  • Maps & Location: OpenStreetMap and additional location services
  • Mobile Apps: Built with cross-platform support to ensure availability on iOS and Android.

📄 How to Contribute

We welcome contributions to this project! Whether you're a developer, designer, or just a public transport enthusiast, we'd love to have you collaborate. Here's how you can get started:

  1. Fork this repository and clone it locally.
  2. Explore the issues tab to find tasks you'd like to work on.
  3. Submit a pull request with your contributions.

Make sure to check out our contribution guidelines to follow the best practices.

🔄 Versioning and Releases

The project is actively being developed, and we plan to release v1.0.0 soon.

📝 License

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

📬 Contact

For questions, ideas, or suggestions, feel free to open an issue or reach out directly to the project maintainers!


Ceylon Public Transit is an ongoing project with continuous development. Join us in building a smarter, more connected public transport system for Sri Lanka!

🧑‍💻 Contributors

Lisara Yatiwala (LismaxB) - Project Founder and Lead Developer

🌍 Let's Make Public Transit Smarter Together!

Join us on this exciting mission to make public transport in Sri Lanka more accessible and efficient for everyone. Let’s build something great! 💡✨