mirror of
https://github.com/bulwarkmail/native.git
synced 2026-11-02 16:07:12 +00:00
50 lines
2.2 KiB
Markdown
50 lines
2.2 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
|
|
- Android: contacts and calendars sync both ways with the phone's Contacts and Calendar apps (Settings → Contacts / Calendar → Sync to this device)
|
|
- In-app sideload updates from GitHub Releases
|
|
|
|
## What's missing or rough
|
|
|
|
- iOS builds, but push notifications, client certificates and syncing with the phone's contacts and calendars 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).
|