Repository navigation
ThunderWren Wear OS Prototype v0.1.0-beta4
Pre-releaseThunderWren v0.1.0-beta4 🐦⚡
Ready for the Thunderbird team. This beta doesn't add new features. It changes how ThunderWren is built so it follows Thunderbird for Android's own rules for new features, builds, and code, which is what a submission to the Thunderbird team needs.
Tested on paired phone and watch emulators in Android Studio. Not yet tried on a physical watch.
🚩 Feature flags
The phone-side parts are now behind Thunderbird feature flags, so they can be turned on step by step (Daily, then Beta, then Release) and turned off again without an app update.
wear_companion: sending your inbox to the watch and handling its requests. While it's off, the watch says to update Thunderbird on your phone.wear_notification_quick_reply: replying to Thunderbird notifications on the watch without opening the phone. While it's off, Reply opens the compose screen on the phone, as before.
Both flags are on in debug builds and off elsewhere for now. In debug builds, you can switch them in Thunderbird's secret debug settings.
🏗️ Daily and Beta watch builds
The watch app now has the same builds as the phone app: debug, daily, beta, and release, with matching app IDs and signing. Each watch build connects to the matching phone build. You can only sign Daily and Beta builds if you have Thunderbird's signing keys, so use debug builds for local testing.
🧹 Code quality
- The watch screens follow Thunderbird's MVI screen pattern: a contract with state, events, and effects, and a view model built on
BaseViewModel. - Unread counts use proper plurals ("1 unread", "2 unread").
- Watch replies log through Thunderbird's
Logger, and never log message content. - The tests follow the repository's naming conventions.
- RFC 0010 now has a rollout plan and a new open question about version codes for the phone and watch apps.
- The README states which parts were written with AI.
🧪 Try it
git fetch --tags && git checkout v0.1.0-beta4, or pullmain.- Run
app-thunderwrenon a Wear OS emulator (API 30+) and tap Try the demo. No phone needed. - For real mail, also run
app-thunderbirdwith thefullDebugvariant on a paired phone emulator with Google Play. The flags are already on in this build.
The watch app reports version 0.1.0-beta4. Details are in the README and RFC 0010.
Built with AI assistance (Claude Code) and tested by the maintainer. AI-generated code is held to the same review standards as any other code, following AGENTS.md.