ROADSoS is a world-class emergency assistance platform that transforms your smartphone into an autonomous digital first responder. By combining real-time location intelligence, high-performance service discovery, and secure live tracking, ROADSoS provides critical coordination when every second counts.
- 🌍 Global Localization (i18n): Full multi-language support across dozens of languages. The app automatically adapts its UI and voice guidance to your selected locale.
- 🚨 Region-Specific SOS: Automatically detects your country via GPS and provides direct-dial buttons for local authorities (e.g., 911, 112, 100/108).
- 🗺️ Intelligent Service Discovery: Instantly locates nearby hospitals, clinics, police stations, and repair shops using an optimized Overpass API integration with intelligent caching.
- 🛰️ Live SOS Tracking: Secure WebSocket streams allowing emergency contacts to watch your GPS location move live on a shared dashboard.
- ⚡ Advanced Reliability & Performance:
- Connection Pooling: Backend optimized with global HTTP connection pooling for lightning-fast service discovery.
- Smart Geolocation: Dual-mode GPS strategy that balances extreme accuracy during emergencies with battery-efficient background monitoring.
- Zero-Stale Geolocation: Forced fresh GPS locks to ensure accuracy in fast-moving emergencies.
- 🎯 Precision Haptics: Native-feel physical feedback for critical actions, ensuring clarity in high-stress situations.
- 💓 Vital Monitoring (rPPG): Experimental camera-based heart rate monitoring using pixel analysis for immediate vital assessment.
- Bio-Signals: rPPG Pixel Analysis (Canvas API)
- Voice: Web Speech API (Synthesis & Recognition)
- Framework: React 19 (TypeScript)
- Animations: Framer Motion (Fluid gestures & staggered transitions)
- Connectivity: WebSockets (Bidirectional streaming)
- Mapping: React-Leaflet / OSRM Routing Engine
- PWA: Fully offline-capable with Service Workers
- Framework: FastAPI (Python 3.10+)
- HTTP Engine: HTTPX with Connection Pooling
- Session Management: UUID-based secure tracking sessions
cd backend
python -m venv venv
source venv/bin/scripts/activate # Windows: .\venv\Scripts\activate
pip install -r requirements.txt
python main.pyBackend runs on http://localhost:8000
cd frontend
npm install
npm run devFrontend runs on http://localhost:5173
The backend provides a clean REST API. Once the backend is running, you can access the interactive Swagger docs at:
http://localhost:8000/docs
GET /api/emergency-services
- Params:
lat,lon,radius(meters) - Returns: Geo-tagged list of nearby emergency facilities.
ROADSoS is a support tool. Always dial local emergency numbers (911, 112, 999) as your first course of action in a life-threatening situation.
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Developed with ❤️ for Global Safety.