SafeMesh

AI-Powered Real-Time Safety Response Network

SafeMesh is an intelligent safety system that connects emergency services, device capabilities, safe routing, and trusted contacts into one coordinated response. It focuses on women and child safety, providing an ecosystem of real-time support across mobile, wearables, and web.

Key Innovation & Features

• AI-Powered Safe Routing: Recommends safer, populated escape routes instead of just the shortest path.
• Offline-First Emergency Support: Core actions function with limited/no internet using GPS, SMS/calls, and local processing.
• 100m Response Network: Opt-in geospatial matching alerts eligible nearby SafeMesh users within a 100m radius to provide immediate help, maintaining strict privacy (consent-first, no passive browsing).
• Existing Infrastructure Integration: Works with existing emergency networks like 112/ERSS instead of replacing them.
• Multi-Signal Verification (Hands-Free Safety): Trigger SOS via voice, shake, wearable, or panic button to reduce false triggers.
• Incident Memory: Maintains an immutable, real-time, auditable incident log from trigger to resolution.
• Unified Device Ecosystem: Supports Child Watch (Wear OS/Apple Watch), Child Phone (Android/iOS), and Parent Dashboard with guardian controls and configurable safe zones.

System Architecture

SafeMesh operates on a modular, layered architecture:

• Device & Trigger Layer: Web, Mobile, Wearables (SOS, Shake, Panic Button).
• SafeMesh API: Authentication, Events, Push notifications, and Routing.
• Location Engine: PostgreSQL + PostGIS, Geofencing, 100m spatial query matching.
• Maps & Routing: OpenStreetMap (OSM), TomTom, Directions, ETA.
• Audit System: Immutable incident records and compliance logs.

End-to-End Data Flow: Trigger → GPS → Incident → Escalate → 100m Mesh → YES/NO → Navigate → Audit

Tech Stack

Frontend & Device Layer

• React 19 / TypeScript / Vite
• Custom Modern Responsive CSS Design System
• PWA-ready architecture
• Android Trusted Web Activity (TWA) with Native Java Intent Bridge & BLE Mesh Support

Backend & Intelligence

• Node.js (Express 5)
• TomTom Maps & Routing API (Pedestrian routing & geocoding)
• Groq SDK (Llama 3.3 70B) (Intelligent real-time emergency routing reasoning)
• MongoDB + Mongoose (With automated in-memory standalone fallback)
• Uber Sandbox API Integration (Automated ride dispatch pipeline)
• Immutable Incident & Audit Event Logging Engine

Prerequisites

• Node.js (v22.12.0 or higher recommended)
• npm or yarn
• TomTom Developer API Key
• Groq API Key

Environment Variables

To configure the backend, a default .env is provided in the backend directory. Customize it with your keys as needed:

PORT=5000
MONGO_URI=mongodb+srv://<username>:<password>@cluster.mongodb.net/safemesh
TOMTOM_API_KEY=your_tomtom_api_key_here
GROQ_API_KEY=your_groq_api_key_here

# Uber Sandbox Configuration
UBER_ENV=sandbox
UBER_BASE_URL=https://sandbox-api.uber.com
UBER_LOGIN_URL=https://login.uber.com
UBER_CLIENT_ID=your_uber_client_id
UBER_CLIENT_SECRET=your_uber_client_secret
UBER_REDIRECT_URI=http://localhost:5000/api/uber/callback
UBER_SCOPES=request

# Security
ENCRYPTION_KEY=0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef
FRONTEND_URL=http://localhost:5173

Installation & Setup

1. Backend Setup

Navigate to the backend directory, install dependencies, and start the server:

cd backend
npm install
npm start # runs "node server.js"

The backend will run on http://localhost:5000 by default.

2. Frontend Setup

Navigate to the frontend directory, install dependencies, and start the development server:

cd frontend
npm install
npm run dev

The frontend will run on http://localhost:5173 with automated proxying to the backend API.

3. Android App & Direct APK Installation

• Root APK (SafeMesh.apk): Located right at the repository root (./SafeMesh.apk), outside all subfolders, ready for direct transfer and installation on any Android device.
• In-App Direct Download: When launching the web app on any device, a prominent "Download SafeMesh Android App (.APK)" banner is displayed right at the top, enabling instant download with one tap.
• Android Source: The android/ directory contains the complete source code, keystore, and Gradle build files for building and signing the app.

Product Principles & Impact

• Consent-First: No passive nearby-user browsing. Opt-in only.
• Fast & Frictionless: Removes unnecessary steps in emergency UX.
• Location-Aware & Device-Agnostic: Real coordinates drive routing across Web, iOS, Android, and Wearables.
• Auditable: Every alert, match, and response is fully logged for accountability.

License

This project is licensed under the ISC License.