Bus Finder

A modern, user-friendly bus route search and management platform. Find buses, manage routes, and book your journey with ease.

About The Project

Bus Finder is a comprehensive transportation platform that connects bus operators with passengers. It solves the problem of finding reliable bus routes and managing fleet operations efficiently.

What makes it unique:

• Smart search and filtering by route, destination, and availability
• Complete route management with intermediate stoppages
• Real-time bus availability tracking
• User-friendly dashboard for both passengers and operators
• Responsive design that works on all devices

Built With

• React 19.0.0
• Vite 6.1.0
• Tailwind CSS 4.0.6
• React Router DOM 7.1.5
• Swiper
• localStorage for data persistence

Getting Started

Instructions on setting up the project locally.

Prerequisites

Node.js and npm installed on your system:

npm install npm@latest -g

Installation

1. Clone the repository

   git clone https://github.com/your-username/bus-finder.git

2. Install dependencies

   npm install

3. Start the development server

   npm run dev

4. Open in your browser

   http://localhost:5173/
   

Usage

For Passengers:

1. Search for buses by source and destination
2. View available routes with intermediate stoppages
3. Compare options and select a bus
4. Complete booking and get confirmation

For Operators:

1. Register as a bus operator
2. Add buses with route details
3. Define intermediate stoppages
4. Monitor and manage your fleet

// Example: User authentication and dashboard access
// - Sign up / Login
// - Create passenger or operator profile
// - Access personalized dashboard

Features

• User authentication (Passenger & Operator roles)
• Advanced bus search with multiple filters
• Route management with intermediate stoppages
• Real-time bus availability tracking
• Booking confirmation system
• User profile management
• Dashboard for operators to manage fleet
• Schedule optimization

Roadmap

• Landing page
• User authentication
• Bus search functionality
• Route management
• Payment integration
• Real-time GPS tracking
• Mobile app (React Native)
• Admin dashboard for analytics

See the open issues for a full list of proposed features and known issues.

Contributing

Contributions are what make the open source community amazing. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.md for more information.

Contact

Tuman Sutradhar

• GitHub: @tumansutradhar
• Email: connect.tuman@gmail.com
• LinkedIn: Tuman Sutradhar

Project Link: https://github.com/tumansutradhar/bus-finder

Acknowledgments

• Vite
• Tailwind CSS
• React Router
• Swiper