- Dart 99.3%
- Swift 0.3%
- C++ 0.1%
- Ruby 0.1%
| .bundle | ||
| .github | ||
| .vscode | ||
| android | ||
| assets | ||
| dart_sdk@7cba36a550 | ||
| docs | ||
| fastlane | ||
| integration_test | ||
| ios | ||
| lib | ||
| linux | ||
| macos | ||
| packages | ||
| test | ||
| test_driver | ||
| tool | ||
| web | ||
| windows | ||
| .gitignore | ||
| .gitmodules | ||
| .metadata | ||
| analysis_options.yaml | ||
| CODEOWNERS | ||
| CONTRIBUTING.md | ||
| dart_test.yaml | ||
| DCO | ||
| devtools_options.yaml | ||
| Gemfile | ||
| Gemfile.lock | ||
| l10n.yaml | ||
| LICENSE | ||
| LICENSE-APPSTORE-EXCEPTION | ||
| pubspec.firebase.deps.yaml | ||
| pubspec.lock | ||
| pubspec.yaml | ||
| README.md | ||
Caution
The Fluxer Flutter mobile client is still in beta so features will be missing or broken. There is currently no set release date for the app, but you can join our public beta!.
Please checkout the known issues list before reporting an issue.
Fluxer Flutter Client
This is the repo for the official Fluxer mobile / tablet app powered by Flutter (desktop is in the works also but mobile is the main focus currently).
You can follow more about the V1 development and what features are planned/implemented in this Roadmap issue.
Community
For updates, support, and discussion, there is an Fluxer Labs community for all users to be able to join and give feedback.
Join here: Join Link
Download
Apple App Store: Coming when V1 is finished.
Google Play Store: Coming when V1 is finished.
Accrescent: This is something we are interested in doing after V1 and they allow app submissions again.
F-Droid: Coming when V1 is finished.
iOS TestFlight: Join with the TestFlight link.
Obtainium: This is currently the best way to install and keep the Android betas installed and updated. Find out more here.
Android (APK)
Download the latest beta build from GitHub releases.
Most phones (Samsung, Pixel, etc.): install the FCM APK. Look for betafcm in the name, e.g. app-arm64-v8a-betafcm-release.apk. Not sure which file? Pick the one with arm64-v8a, or the universal app-betafcm-release.apk.
Degoogled phones (GrapheneOS, no Google apps): install the OSS APK (betaoss) and set up UnifiedPush (e.g. ntfy).
APK naming (optional)
Files look like app-<cpu>-beta<fcm|oss>-release.apk. FCM and OSS are separate installs; installing one replaces the other.
Auto-updates with Obtainium
Easiest install: use Obtainium to install and auto-update from GitHub. Beta releases are marked pre-release on GitHub, so the link must enable that option — the simple obtainium://add/... URL cannot do this.
Use one of these one-click links (FCM for most phones, OSS for degoogled). Each enables pre-releases, filters to the correct APK (betafcm or betaoss), and picks the right CPU architecture automatically:
- Fluxer Beta (FCM): Add to Obtainium
- Fluxer Beta (OSS): Add to Obtainium
Signing
Stable, beta, and canary Android release builds on GitHub are signed with this SHA-256 certificate fingerprint:
91:E4:98:E1:B8:A6:C8:BA:99:41:5E:DB:29:78:29:6B:6C:58:BA:A5:E2:D2:A6:49:CE:C6:2D:A7:A8:29:C7:BC
Bug reporting
You must report bugs or feedback in Fluxer Labs community and bugs are synced to Github from the community.
Self-hosted instances
The mobile app supports self-hosted instances now! Push notifications are currently only supported for users using the Android OSS build.
For iOS and Android FCM build we will need to set up a relay service for self-hosted instances to use. This is something we mostly have finished (on the backend side), and will allow notifications on both platforms with zero knowledge of message content being passed through the relay.
SSO (Single Sign-On) login is supported on the mobile client. For it to fully work you need to register this redirect URI with your OIDC provider:
fluxer://auth/sso/callback
Contributing (for developers)
During the current beta, we are only accepting contributions for bug fixes. To submit a PR, it must be for a linked reported issue.
After the beta period, we will be updating these guidelines.
Pull requests should target the canary branch. For local testing, use the canary build flavor so your build matches that branch (see Mobile builds below).
Before committing, run bash tool/before_commit.sh to apply dart fix and format tracked Dart files (generated and vendored paths are skipped). CI uses the same file list.
Contribution licensing and sign-off
By contributing you agree your contribution is licensed under the AGPLv3 together with the App Store additional permission (see LICENSE-APPSTORE-EXCEPTION), and you sign off each commit under the Developer Certificate of Origin with git commit -s. There is no signed CLA. See CONTRIBUTING.md for details; this is checked automatically on every pull request.
Translating
App translations are welcome at any time.
Strings are managed on Weblate. You can translate in the browser — no repository checkout or pull request is needed. English is the source language.
Tech stack
- Flutter / Dart — cross platform UI (mobile today, desktop in progress)
- Riverpod — state management (with code generation)
- go_router — navigation and deep links
- Drift — local SQLite database
- Dio — HTTP client
- fluxer_dart — Fluxer API client (OpenAPI generated)
- WebSockets — real time gateway events
- LiveKit / WebRTC — voice and video calls
- FCM / UnifiedPush / APNs — push notifications (platform dependent)
Version numbers
Note
We will transition to this version method after the V1 update.
Releases use {year}.{month}.{public release number}, for example 2026.07.100.
- Year and month are when the release was published.
- Public release number is the release counter for that month. It resets at the start of each month.
- Counters start at 100, then 200, 300, and so on (not 1, 2, 3) so they are not mistaken for a day of the month.
Build generated files
Riverpod generated files are not committed, so you need to generate them before running the project.
dart run build_runner build
Mobile builds
Environments are canary, beta, and stable. Pass compile-time defines with --dart-define-from-file=tool/dart_defines/<environment>.json (each file sets APP_ENVIRONMENT) plus --dart-define=PUSH_PROVIDER=... as needed.
Application ID / bundle ID: beta and stable use com.fluxer. canary uses com.fluxer.canary
Android uses two Gradle flavor dimensions: environment plus push (fcm or unifiedpush). The variant name combines both in camelCase (for example stableFcm, betaUnifiedpush). PUSH_PROVIDER must match the push dimension: fcm for Firebase Cloud Messaging (adds deps via pubspec.firebase.deps.yaml) or unifiedpush for UnifiedPush.
iOS uses schemes with the same environment names (canary, beta, stable). There is no push flavor dimension; push is always Apple Push Notification service, so use PUSH_PROVIDER=apns.
Example (Android, stable with FCM):
flutter run --flavor stableFcm --dart-define-from-file=tool/dart_defines/stable.json --dart-define=PUSH_PROVIDER=fcm
For the same environment on iOS, swap the flavor for the scheme and set PUSH_PROVIDER=apns, for example --flavor stable, --dart-define-from-file=tool/dart_defines/stable.json, and --dart-define=PUSH_PROVIDER=apns.
flutter build ios --flavor canary --dart-define-from-file=tool/dart_defines/canary.json --dart-define=PUSH_PROVIDER=apns
Desktop builds
We plan to provide desktop builds in the future but they will be labled as Fluxer Lite clients. These builds will not replace the Electron verison but be a seperate version you can download.
License
Fluxer Mobile is licensed under the GNU Affero General Public License v3 (AGPLv3), together with an App Store additional permission under section 7 of the AGPLv3 that allows the app to be distributed through application stores (such as the Apple App Store and Google Play) without changing the project's public AGPLv3 licensing.