Privacy-first peer-to-peer messaging built with Flutter.

中文说明 | Technical notes

• ./gungchat contains the Flutter application.
• root-level SESSION_*.md and plan files contain project notes and handoff context.
• ./gungchat/installer contains the Windows installer script.

If you want to build or debug the app, start in ./gungchat.

• Peer-to-peer chat foundations built with Flutter and WebRTC.
• Contact exchange through QR and contact payload import flows.
• Chat, contacts, and settings screens for desktop and mobile targets.
• File, image, audio, and location sharing with media gallery support.
• Privacy-focused features such as app lock, local storage, and contact controls.
• Windows desktop build and installer packaging, plus Android release APK packaging.
• Multilingual support is now wired end to end for English, Simplified Chinese, Traditional Chinese, Spanish, and French. I enabled Flutter localization generation

flowchart LR
    UI[Flutter UI\nChats Contacts Settings] --> State[Riverpod Providers]
    State --> Core[Core Services\nCrypto Storage Preferences]
    State --> P2P[Peer Session Controller]
    P2P --> Signal[LAN Signaling\nQR Import Deep Links]
    P2P --> RTC[WebRTC Data Channel]
    Core --> DB[(Local SQLite)]
    Signal --> Peers[Windows Android iOS Peers]
    RTC --> Peers

Run all commands below from ./gungchat.

flutter pub get

flutter analyze
flutter test

flutter run -d windows

flutter build windows

Output:

• gungchat/build/windows/x64/runner/Release/

& "$env:LOCALAPPDATA\Programs\Inno Setup 6\ISCC.exe" ".\installer\gungchat.iss"

Output:

• gungchat/installer/output/gungchat-setup-<version>.exe

flutter build apk --release

Output:

• gungchat/build/app/outputs/flutter-apk/

iOS builds require macOS and Xcode.

flutter build ios

You can also open gungchat/ios/Runner.xcworkspace in Xcode for signing and device testing.

• Automated checks: flutter analyze and flutter test
• Windows smoke test guide: gungchat/WINDOWS_11_BUILD_AND_SMOKE_TEST.md
• Manual cross-device test guide: gungchat/PHASE_9_7_MANUAL_TEST_CHECKLIST.md
• Deeper technical background: README.TECH.md

We need more contributors, especially Apple developers.

We especially need help with:

• building the iOS target on macOS with Xcode
• testing on real iPhone and iPad hardware
• validating permissions, local auth, file flows, and chat behavior on iOS
• debugging signing, device deployment, and App Store readiness issues
• cross-platform Windows and Android chat testing
• WebRTC and peer connectivity debugging

If you want to help, please open an issue or send a pull request.