How adicodeswell/blackout works
This repository is a React Native emergency-response app with offline geolocation and an Android peer-to-peer mesh implementation. The intended workflow is to enter through the app, use location and offline-map routing to orient response, and exchange emergency messages with nearby peers; the contracts also define incident, evidence, resource, and AI capabilities. The README is only the stock React Native setup guide, so product behavior is inferred from source and contracts. Some native and data subsystems are unsampled; their links are omitted or marked unverified.
Main entry points: OfflineGeoEngine.java Offline geo engine · AndroidNetworkEngine.java Android network engine · ConnectionManager.java Connection manager · OutgoingSendManager.java Outgoing sends
Components 28
App and bridges
- React Native app
App.tsx - Native bridge adapter
src/adapters/native/NativeBridgeAdapter.ts - Blackout native module
android/app/src/main/java/com/blackout/bridge/BlackoutNativeModule.java
Offline geolocation
- Geo adapter
src/adapters/geo/GeoEngineAdapter.ts - Offline geo engine
android/app/src/main/java/com/blackout/geolocation/OfflineGeoEngine.java - Location provider and validation
android/app/src/main/java/com/blackout/geolocation/AndroidLocationProvider.java - Offline map loading
android/app/src/main/java/com/blackout/geolocation/OfflineMapManager.java - Map sources and cache
android/app/src/main/java/com/blackout/geolocation/source - Hazard projection
android/app/src/main/java/com/blackout/geolocation/HazardProjector.java - Road graph
android/app/src/main/java/com/blackout/geolocation/RoadGraph.java - A-star routing
android/app/src/main/java/com/blackout/geolocation/AStarRouter.java - Nearby search
android/app/src/main/java/com/blackout/geolocation/NearbySearch.java
Peer mesh networking
- Network adapter
src/adapters/network/NetworkEngineAdapter.ts - Android network engine
android/app/src/main/java/com/blackout/network/engine/AndroidNetworkEngine.java - Peer discovery
android/app/src/main/java/com/blackout/network/discovery - Connection manager
android/app/src/main/java/com/blackout/network/transport/ConnectionManager.java - Peer connections
android/app/src/main/java/com/blackout/network/transport/PeerConnection.java - Network server
android/app/src/main/java/com/blackout/network/transport/NetworkServer.java - Outgoing sends
android/app/src/main/java/com/blackout/network/transport/OutgoingSendManager.java - Message protocol
android/app/src/main/java/com/blackout/network/protocol/NetworkMessage.java - Peer handshake
android/app/src/main/java/com/blackout/network/protocol/HandshakeManager.java - Delivery and forwarding
android/app/src/main/java/com/blackout/network/reliability - Mesh foreground service
android/app/src/main/java/com/blackout/network/service/MeshForegroundService.java
Response data and AI
- Data engine adapter
src/adapters/data/DataEngineAdapter.ts - Reports, incidents, resources
src/contracts/data/DataEngine.ts - AI engine adapter
src/adapters/ai/AIEngineAdapter.ts - AI contracts
src/contracts/ai/AIEngine.ts
Other components
- App user
Connections 24
- App user → React Native app: uses
App.tsx - React Native app → Native bridge adapter: imports
App.tsx - Native bridge adapter → Blackout native module: bridges to
- Geo adapter → Offline geo engine: delegates to
- Offline geo engine → Location provider and validation: reads location
android/app/src/main/java/com/blackout/geolocation/OfflineGeoEngine.java - Offline geo engine → Offline map loading: loads maps
android/app/src/main/java/com/blackout/geolocation/OfflineGeoEngine.java - Offline map loading → Map sources and cache: loads from
android/app/src/main/java/com/blackout/geolocation/OfflineMapManager.java - Offline geo engine → Hazard projection: projects hazards
android/app/src/main/java/com/blackout/geolocation/OfflineGeoEngine.java - Offline geo engine → Road graph: routes on
android/app/src/main/java/com/blackout/geolocation/OfflineGeoEngine.java - Offline geo engine → A-star routing: calculates route
android/app/src/main/java/com/blackout/geolocation/OfflineGeoEngine.java - Offline geo engine → Nearby search: searches nearby
- Network adapter → Android network engine: delegates to
- Android network engine → Peer discovery: discovers peers
android/app/src/main/java/com/blackout/network/engine/AndroidNetworkEngine.java - Android network engine → Connection manager: manages connections
android/app/src/main/java/com/blackout/network/engine/AndroidNetworkEngine.java - Android network engine → Network server: uses server
android/app/src/main/java/com/blackout/network/engine/AndroidNetworkEngine.java - Connection manager → Peer connections: starts and sends
android/app/src/main/java/com/blackout/network/transport/ConnectionManager.java - Outgoing sends → Connection manager: sends through
android/app/src/main/java/com/blackout/network/transport/OutgoingSendManager.java - Outgoing sends → Message protocol: serializes
android/app/src/main/java/com/blackout/network/transport/OutgoingSendManager.java - Peer handshake → Connection manager: uses connections
android/app/src/main/java/com/blackout/network/protocol/HandshakeManager.java - Peer handshake → Message protocol: exchanges messages
android/app/src/main/java/com/blackout/network/protocol/HandshakeManager.java - Delivery and forwarding → Outgoing sends: forwards messages
android/app/src/main/java/com/blackout/network/reliability/ForwardingEngine.java - Mesh foreground service → Android network engine: starts mesh
- Data engine adapter → Reports, incidents, resources: implements contract
src/adapters/data/DataEngineAdapter.ts - AI engine adapter → AI contracts: implements contract
src/adapters/ai/AIEngineAdapter.ts