JeffGandGitHub
ec18bcce2c
* Add version to settings footer, bump whitenoise crate rev
* Update icons and get staging iOS updated for TestFlight
* fix: surface group operation errors to the user
- GroupInfoScreen: show error notice when member list fails to load
- SetUpGroupScreen: show warning notice when group image upload fails
(group is created successfully but user is informed the image didn't upload)
- EditGroupScreen: show save failure as a notice and keep Save/Cancel
buttons visible so the user can retry, rather than replacing the form
Refactors useCreateGroup.createGroup to return ({Group? group, bool
imageUploadFailed}) instead of Group?, making partial success explicit
in the return value rather than as a state side-effect.
* fix(l10n): translate groupImageUploadFailed into all supported locales
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.