PepiandGitHub
322207a4a3
* feat: add replying to state to chat input hook * feat: add reply preview type * feat: get reply preview in user chat messages hook * feat: add reply preview widget * feat: add optional reply preview to message bubble * feat: add on reply callback to message actions screen * feat: add reply tags support to message service * feat: add reply support in chat screen * chore: ignore coverage of reply preview typedef file cause lcov considers 0% because it has no executabel code, but it does have tests * fix: author metadata fetch and rebuild
White Noise
A secure, private, and decentralized chat app using the marmot protocol 🦫 to build secure messaging with MLS and Nostr
📱 Supported Platforms
- ✅ Android - Fully supported
- ✅ iOS - Fully supported
- ⏳ macOS - Not supported yet
- ⏳ Windows - Not supported yet
- ⏳ Linux - Not supported yet
- ⏳ Web - Not supported yet
Structure
lib/
├── constants/ # Shared constants: fixed, related sets or reused elsewhere only
├── providers/ # Shared state
├── hooks/ # Ephemeral widget state
├── services/ # Stateless operations (API calls)
├── screens/ # Full-page components
├── widgets/ # Reusable components
🏗️ Stack
- Flutter
- Rust
- flutter_rust_bridge - Dart ↔ Rust integration
- whitenoise rust crate 🦀
Prerequisites
- Flutter SDK (3.24.x or later)
- Rust (latest stable)
- Just -
cargo install just - flutter_rust_bridge_codegen -
cargo install flutter_rust_bridge_codegen
🛠️ Commands
# Install dependencies
just deps # Install both Flutter and Rust deps
just deps-flutter # Flutter dependencies only
just deps-rust # Rust dependencies only
# Format code
just format # Format both Rust and Dart
just format-rust # Format Rust only
just format-dart # Format Dart only
# Coverage
just coverage # Checks tests coverage
Coverage Report
You need to install lcov to generate report
# Mac OS
brew install lcov
# Linux
apt-get install lcov
# First run tests with coverage option
flutter test --coverage
# Generate coverage html report
genhtml coverage/lcov.info -o coverage/html
# Open coverage/html/index.html in your browser
Development philosophy
- We keep complexity low.
- We keep the app thin.
- We test our code.
- We delete dead code. Commented code is dead code.
- We use the Whitenoise Rust crate as the source of truth.
- We avoid caching in Flutter; the Whitenoise crate already persists data in a local DB.
- We put shared app state in providers.
- We put ephemeral widget state in hooks.
- We pass data to hooks, not widget refs.
- We let screens watch providers and pass data to hooks.
- We avoid comments unless strictly necessary and write self-explanatory code.