EDOHWARES/SafeRoute-NG

SafeRoute Nigeria: A safety-first platform providing real-time road condition alerts, collecting feedback via USSD, and rewarding transporters with airtime incentives for safer and more efficient journeys. # SafeRoute Nigeria 🚦 SafeRoute Nigeria is a modern web application that provides real-time road condition insights, safety alerts, and feedback collection for road users and transporters in Nigeria. --- ## Features 🚀 - **Real-Time Road Condition Map & List**: View up-to-date road statuses (Safe, Risky, Blocked) with color-coded indicators and filtering. - **Responsive UI**: Clean, modern, and mobile-friendly design. - **Instant Notifications**: Receive SMS alerts for critical road events. - **Feedback via USSD**: Report road issues or provide feedback using USSD codes. - **Airtime Rewards**: Transporters earn airtime for safe driving milestones. --- ## Screenshots 📸 --- ## Tech Stack 💻 - **Frontend**: React.js + Vite + Tailwind CSS - **Backend**: Node.js (Express) - **Database**: MongoDB - **APIs**: Africa's Talking (SMS, USSD, Airtime) --- ## Getting Started ⚡ ### Prerequisites - Node.js (v16+ recommended) - npm or yarn ### Installation 1. Clone the repository: ```bash git clone github.com cd SafeRoute-NG ``` 2. Install dependencies for each app (admin, client, server): ```bash cd admin && npm install cd ../client && npm install cd ../server && npm install ``` 3. Set up environment variables (see `.env.example` in each folder). 4. Start the apps: ```bash # In separate terminals cd admin && npm run dev cd ../client && npm run dev cd ../server && npm start ``` --- ## Contributing 🤝 Pull requests are welcome! For major changes, please open an issue first. --- ## License MIT