FundacjaHospicjum/crisis-mesh-messenger

Tópicos técnicos

# android # crisis-communication # dart # decentralized # disaster-response # flutter # humanitarian # ios # mesh-networking # offline-first # p2p

Dependências usadas

Lista de dependências 24 itens

flutter{"sdk":"flutter"}
provider^6.1.2
get_it^8.0.0
hive^2.2.3
hive_flutter^1.1.0
path_provider^2.1.4
encrypt^5.0.3
cryptography^2.7.0
flutter_nearby_connections^1.1.2
nearby_connections^3.1.0
permission_handler^11.3.1
network_info_plus^6.0.0
connectivity_plus^6.1.0
device_info_plus^10.1.2
cupertino_icons^1.0.8
flutter_svg^2.0.10+1
intl^0.19.0
uuid^4.5.1
logger^2.4.0
equatable^2.0.5
flutter_testDesenvolvimento{"sdk":"flutter"}
flutter_lintsDesenvolvimento^4.0.0
hive_generatorDesenvolvimento^2.0.1
build_runnerDesenvolvimento^2.4.13

Rankings

Rising#83

README original

Texto original em inglês. Visite o GitHub para a versão atual.

Expandir / recolher README

Crisis Mesh Messenger

A decentralized, infrastructure-free messaging application for crisis situations.

Overview

Crisis Mesh Messenger enables people to communicate when traditional infrastructure (internet, cell towers) fails due to:

Natural disasters
War and conflict
Censorship
Remote locations

Messages hop from device to device using Bluetooth and WiFi Direct, creating a resilient mesh network that requires no central infrastructure.

Key Features

✅ No internet or cell towers required
✅ Device-to-device messaging (Bluetooth/WiFi)
✅ End-to-end encryption
✅ Store-and-forward routing
✅ Works on Android and iOS
✅ Free and open source

Quick Start

# Install dependencies
flutter pub get

# Run on Android
flutter run

# Run on iOS
flutter run -d iPhone

Architecture

Technology Stack

Framework: Flutter 3.29+
State Management: Provider + GetIt (MVVM)
Local Storage: Hive (encrypted)
Communication:
- Android: Nearby Connections API, WiFi Direct, Bluetooth LE
- iOS: Multipeer Connectivity, Bluetooth LE
Encryption: End-to-end using libsodium

Project Structure

lib/
├── core/
│   ├── di/              # Dependency injection setup
│   ├── models/          # Data models
│   ├── services/        # Business logic services
│   └── utils/           # Utilities and constants
├── features/
│   ├── messaging/       # Chat and conversations
│   ├── network/         # Mesh network management
│   └── settings/        # App settings
├── ui/
│   ├── screens/         # Screen widgets
│   ├── widgets/         # Reusable widgets
│   └── theme/           # App theming
└── main.dart

Development Status

Phase 1: Proof of Concept ✅ READY TO RUN

[x] Project structure
[x] Basic UI (Home, Chat, Network Status screens)
[x] UI components (message bubbles, conversation list)
[x] Local storage (Hive with models)
[x] Service architecture (MVVM with Provider/GetIt)
[x] Platform configurations (Android & iOS)
[x] Simulated peer discovery
[ ] Real Bluetooth/WiFi networking (Next phase)

License

MIT License - Free for humanitarian use

Contributing

This is a humanitarian project. Contributions welcome!

Contact

For collaboration or questions, see documentation in /docs.