🚌 CommuteSense v2.0

Student transport reporting platform for Auckland buses with real-time tracking, gamification, and interactive maps.

Features

• 📍 GPS-based route detection - Auto-suggests nearby bus stops
• 🗺️ Interactive maps - Real-time visualization of bus issues
• 🏆 Gamification - Points, badges, and leaderboards
• 📊 Analytics dashboard - Route reliability tracking
• 📱 Mobile-friendly - Responsive design for all devices

Tech Stack

Frontend: React, Leaflet, Recharts, Axios
Backend: Flask, SQLAlchemy, SQLite, Geopy
APIs: OpenStreetMap, Browser Geolocation

Installation

Backend

cd backend
python -m venv venv
venv\Scripts\activate  # Windows
pip install -r requirements.txt
python app.py

Frontend

cd frontend/commutesense-v2
npm install
npm start

Usage

1. Open http://localhost:3000
2. Allow location access
3. Submit bus issue reports
4. View real-time dashboard and maps

License

MIT License

Author

Built for Auckland students 🚀