mirror of
https://github.com/bulwarkmail/native.git
synced 2026-10-31 16:06:32 +00:00
Linus Rath
5237848312
`docs/android-release.md` walks through generating the release key with keytool, creating the debug-to-release signing lineage with `apksigner rotate` and which capabilities the debug key keeps, the five repository secrets, and how to check the first rotated release on the emulators. It spells out what rotation protects and what it does not: devices that have not updated yet, Android 7.0-8.1, which still verify the debug-signed v2 signature, and when the lineage can be dropped. It also covers local release builds and the `versionCode` formula. The README links to it instead of the bare workflow file.
49 lines
2.0 KiB
Markdown
49 lines
2.0 KiB
Markdown
<div align="center">
|
|
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/bulwarkmail/webmail/refs/heads/main/public/branding/Bulwark_Logo_with_Lettering_White_and_Color.svg" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/bulwarkmail/webmail/refs/heads/main/public/branding/Bulwark_Logo_with_Lettering_Dark_Color.svg" />
|
|
<img src="https://raw.githubusercontent.com/bulwarkmail/webmail/refs/heads/main/public/branding/Bulwark_Logo_with_Lettering_Dark_Color.svg" alt="Bulwark Webmail" width="280" />
|
|
</picture>
|
|
|
|
</div>
|
|
|
|
# Bulwark Mobile
|
|
|
|
> **Beta - work in progress.** Many features are unfinished or rough. Expect bugs, missing functionality, and breaking changes between releases. Do not rely on this for primary email yet.
|
|
|
|
React Native (Expo SDK 54) client for [Bulwark Webmail](https://github.com/bulwarkmail/webmail) - a JMAP-based mail, calendar, and contacts app.
|
|
|
|
## What works today
|
|
|
|
- Sign in to any JMAP server (e.g. Stalwart)
|
|
- Multiple accounts
|
|
- Email list, threads, compose
|
|
- Calendar (basic)
|
|
- Contacts (basic)
|
|
- Push notifications via the Bulwark relay - FCM by default, or [UnifiedPush](https://unifiedpush.org) (e.g. ntfy) for devices without Google Play services
|
|
- In-app sideload updates from GitHub Releases
|
|
|
|
## What's missing or rough
|
|
|
|
- iOS builds, but push notifications and client certificates are Android-only so far
|
|
- S/MIME, plugins, themes - UI stubs only (filters & rules, the vacation responder and file storage are real implementations)
|
|
- Calendar editing is partial; contacts editing is basic
|
|
- No Play Store distribution yet (sideload APK from Releases); iOS ships via TestFlight
|
|
|
|
## Run locally
|
|
|
|
```bash
|
|
npm install
|
|
npx expo start
|
|
```
|
|
|
|
Then press `a` for Android, `i` for iOS, or scan the QR with Expo Go.
|
|
|
|
For release APK builds and signing see [docs/android-release.md](docs/android-release.md).
|
|
For iOS builds and TestFlight distribution see [docs/ios-release.md](docs/ios-release.md).
|
|
|
|
## License
|
|
|
|
AGPL-3.0-only. See [LICENSE](LICENSE).
|