Shuttle Tracker 🚍

A real-time bus tracking and pick-up notification system built for NST students.

---

✨ Overview

The Shuttle Tracker web-app lets students see the exact location of their college shuttle, request a pick-up with one tap, and display their class schedule to the driver—reducing confusion and unnecessary calls.

Impact

Role	Benefits
Students	Shorter waiting times, on-time arrivals
Drivers	Fewer calls, clearer routing
Faculty	Fewer class disruptions
NST Management	More disciplined, data-driven transport system

---

🚀 Tech Stack

• Frontend: React 18 + Vite

---

🛠️ Local Setup

Prerequisites: Node ≥ 18 & npm

# 1. Clone & enter project
git clone <repo-url>
cd Shuttle_Tracker

# 2. Install frontend deps
cd frontend
npm install

# 3. Start dev server
npm run dev

The app will be served on http://localhost:5173.

---

📂 Project Structure

Shuttle_Tracker/
 ├─ frontend/      # React web client
 │   ├─ src/
 │   │   ├─ App.jsx
 │   │   └─ …
 │   ├─ index.html
 │   └─ vite.config.js
 └─ backend/       # (coming soon)

---

🤝 Contributing

1. Fork the repo & create a feature branch (git checkout -b feature/xyz).
2. Commit your changes with clear messages.
3. Open a Pull Request.

---

📄 License

This project is released under the MIT License — see LICENSE for details.