How ashfak99/hackinverse-women-safety works
Nari-Suraksha is an offline-first Android safety app: a user triggers SOS, a cancel countdown precedes local audio/location capture, and BLE broadcasts the alert to nearby phones; responders can acknowledge it. The app also provides decoy-calculator access, background scanning, incident history, and safe-zone information. A React web portal presents product information and an interactive simulator. Android startup and SOS orchestration are supported by excerpts; several feature branches are documented in the README but their implementation files were not sampled, so those links cite the README.
Main entry points: MainViewModel.kt Main view model · App.jsx Web portal shell · MainActivity.kt App entry · SosForegroundService.kt SOS broadcast service
Components 26
Android experience
- App entry
app/src/main/java/com/brokencoders/narisuraksha/MainActivity.kt - Main view model
app/src/main/java/com/brokencoders/narisuraksha/ui/viewmodels/MainViewModel.kt - Home and alert UI
app/src/main/java/com/brokencoders/narisuraksha/ui/screens/HomeScreen.kt - Calculator decoy
app/src/main/java/com/brokencoders/narisuraksha/decoy/CalculatorEngine.kt - Safe zones
app/src/main/java/com/brokencoders/narisuraksha/ui/screens/SafeZoneScreen.kt
SOS workflow
- SOS countdown manager
app/src/main/java/com/brokencoders/narisuraksha/trigger/SosManager.kt - Shake trigger
app/src/main/java/com/brokencoders/narisuraksha/trigger/ShakeDetector.kt - Audio evidence
app/src/main/java/com/brokencoders/narisuraksha/capture/AudioRecorder.kt - GPS capture
app/src/main/java/com/brokencoders/narisuraksha/capture/LocationProvider.kt - SOS broadcast service
app/src/main/java/com/brokencoders/narisuraksha/service/SosForegroundService.kt
BLE mesh
- SOS packet
app/src/main/java/com/brokencoders/narisuraksha/core/SosPacket.kt - BLE transport
app/src/main/java/com/brokencoders/narisuraksha/ble/BleTransportImpl.kt - BLE advertiser
app/src/main/java/com/brokencoders/narisuraksha/ble/BleAdvertiser.kt - BLE scanner
app/src/main/java/com/brokencoders/narisuraksha/ble/BleScanner.kt - Background guardian
app/src/main/java/com/brokencoders/narisuraksha/service/ScanForegroundService.kt
State and services
- User preferences
app/src/main/java/com/brokencoders/narisuraksha/data/UserPreferencesRepository.kt - Incident database
app/src/main/java/com/brokencoders/narisuraksha/data/AppDatabase.kt - Incident history
app/src/main/java/com/brokencoders/narisuraksha/ui/viewmodels/HistoryViewModel.kt
Web portal
- Web portal shell
frontend/src/App.jsx - BLE and decoy simulator
frontend/src/components/InteractiveSimulator.jsx - Feature overview
frontend/src/components/FeatureGrid.jsx - Safe-zone explorer
frontend/src/components/SafeZonesExplorer.jsx - Offline architecture display
frontend/src/components/OfflineArchitecture.jsx - Android download
frontend/src/components/DownloadSection.jsx
Other components
- Phone user
- Nearby responder phone
Connections 31
- Phone user → App entry: opens app
README.md - App entry → Main view model: creates
app/src/main/java/com/brokencoders/narisuraksha/MainActivity.kt - App entry → Home and alert UI: navigates to
app/src/main/java/com/brokencoders/narisuraksha/MainActivity.kt - Home and alert UI → Main view model: observes state
app/src/main/java/com/brokencoders/narisuraksha/ui/screens/HomeScreen.kt - Phone user → Home and alert UI: triggers SOS
README.md - Phone user → Calculator decoy: enters secret PIN
README.md - Calculator decoy → SOS countdown manager: covert trigger
README.md - Phone user → Shake trigger: shakes phone
README.md - Main view model → Shake trigger: starts or stops
app/src/main/java/com/brokencoders/narisuraksha/ui/viewmodels/MainViewModel.kt - Main view model → SOS countdown manager: handles SOS events
app/src/main/java/com/brokencoders/narisuraksha/ui/viewmodels/MainViewModel.kt - SOS countdown manager → Audio evidence: starts recording
app/src/main/java/com/brokencoders/narisuraksha/trigger/SosManager.kt - SOS countdown manager → GPS capture: fetches coordinates
app/src/main/java/com/brokencoders/narisuraksha/trigger/SosManager.kt - Main view model → SOS broadcast service: starts service
app/src/main/java/com/brokencoders/narisuraksha/ui/viewmodels/MainViewModel.kt - SOS broadcast service → SOS packet: creates packet
app/src/main/java/com/brokencoders/narisuraksha/service/SosForegroundService.kt - SOS broadcast service → BLE transport: starts advertising
README.md - BLE transport → BLE advertiser: dispatches broadcast
- BLE advertiser → Nearby responder phone: broadcasts SOS
README.md - Nearby responder phone → BLE scanner: sends ACK beacon
README.md - BLE scanner → BLE transport: returns received alerts
- Background guardian → BLE transport: starts scanning
app/src/main/java/com/brokencoders/narisuraksha/service/ScanForegroundService.kt - Background guardian → Incident database: records received SOS
- SOS broadcast service → Incident database: persists sent event
app/src/main/java/com/brokencoders/narisuraksha/service/SosForegroundService.kt - Main view model → User preferences: reads settings
app/src/main/java/com/brokencoders/narisuraksha/ui/viewmodels/MainViewModel.kt - App entry → Incident history: creates view model
app/src/main/java/com/brokencoders/narisuraksha/MainActivity.kt - Incident history → Incident database: loads incidents
- Phone user → Safe zones: views help locations
README.md - Web portal shell → BLE and decoy simulator: renders
frontend/src/App.jsx - Web portal shell → Feature overview: renders
frontend/src/App.jsx - Web portal shell → Safe-zone explorer: renders
frontend/src/App.jsx - Web portal shell → Offline architecture display: renders
frontend/src/App.jsx - Web portal shell → Android download: renders
frontend/src/App.jsx