// the find
robertodoering/harpy
a Twitter app built with Flutter 🦅
Harpy is a full-featured third-party Twitter client for Android (with partial iOS support) built in Flutter, with theme customization, video playback, and deeplink routing. It was a production app with 75k active users until Twitter killed third-party API access in 2023. It's now archived — useful as a reference implementation, not something you'd ship.
The state management architecture is well thought out: riverpod for DI plus state_notifier keeps business logic out of widgets in a way that's actually testable. The free/pro product flavor setup in Android is a clean real-world example of how to split a Flutter app without duplicating the whole codebase. The author wrote a custom twitter_api package rather than pulling in a half-maintained community lib, which kept the HTTP layer under control. The Fastlane + GitHub Actions CI pipeline is production-grade with per-flavor build and release tracks.
Dead on arrival for anyone wanting to actually use it — the Twitter v1.1 API it depends on is shut off for third parties, so you can't log in. iOS support appears to exist in the Xcode project but was never fully shipped. The Rive/Flare animation files use the old .flr format, which Rive deprecated years ago, so those animations would need to be rebuilt. No web or desktop target despite Flutter supporting them, which limits its value as a Flutter architecture reference for those platforms.