Skip to content

soumyadeepsarkar-2004/bus_finder

 
 

Repository files navigation

🚌 Bus Tracking Platform

A simple bus tracking platform that allows users to register, add buses, and search for available routes.
The application is built using React and stores data locally in localStorage (No Backend).

🚀 Live Demo: Click Here

🌟 Features

🚍 Bus Management

  • Car owners can add new buses with:
    • Bus Name & Number
    • Start & Destination Locations
    • Departure & Arrival Times
    • Stoppages with Timings
  • 🚫 Owners cannot edit buses but can delete and add new ones

🔎 Search & Tracking

  • Find buses by Start and Destination locations
  • Displays real-time arrival & departure times
  • Shows "No buses found" message if no results match

📊 User Dashboard

  • Users can view and manage their added buses
  • Dashboard auto-updates when buses are added or removed

📱 Responsive UI

  • Works seamlessly on desktop, tablets, and mobile

🛠 Tech Stack

  • Frontend: React, Tailwind CSS
  • Data Storage: Local Storage (No backend)

🔥 Fork & Clone the Repository

Step 1: Fork the Repository

  1. Click the "Fork" button at the top right of the repository page.
  2. This creates a copy under your GitHub account.

Step 2: Clone Your Fork

Copy and run this command in your terminal:

git clone https://github.com/YOUR-USERNAME/bus_finder.git

Navigate to the Project Directory

cd bus_finder

Install Dependencies

npm install

Run the following command to install Tailwind CSS v4:

npm install tailwindcss @tailwindcss/vite

To enable navigation between different pages, install React Router DOM:

npm install react-router-dom

Run the following command to start the local development server:

npm run dev

This will launch your app on http://localhost:5173/

👥 Contributors

⭐ Give a Star

If you like this project, please consider giving it a ⭐!
Your support helps improve and maintain the project.

Star

📩 Contact

For any queries or issues, feel free to reach out:

🔗 GitHub Issues: Open an issue

About

Bus routes finding platform.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 98.0%
  • HTML 1.9%
  • CSS 0.1%