Awesome
<p align="center"> <img max-height="172" width="80%" src="media/title.png"/> </p> <p align="center"> a feature rich Twitter experience built with <a href="https://flutter.dev/">Flutter</a> </p> <br> <p align="center"> <a href="https://github.com/robertodoering/harpy/stargazers"><img src="https://img.shields.io/github/stars/robertodoering/harpy?color=8B00FD&logo=github"/></a> <a href="https://github.com/robertodoering/harpy/releases"><img src="https://img.shields.io/github/v/release/robertodoering/harpy?color=BC0492"/></a> <a href="https://github.com/robertodoering/harpy/commits/master"><img src="https://img.shields.io/github/commits-since/robertodoering/harpy/latest?color=F2091C"/></a> <a href="https://github.com/robertodoering/harpy/commits/master"><img src="https://img.shields.io/github/commit-activity/m/robertodoering/harpy?color=FD0A04"/></a> </p> <p align="center"> <a href="https://github.com/Solido/awesome-flutter"> <img src="https://img.shields.io/badge/Awesome-Flutter-blue.svg?longCache=true"/> </a> <a href="https://github.com/robertodoering/harpy/actions/workflows/flutter_push.yml"> <img src="https://github.com/robertodoering/harpy/actions/workflows/flutter_push.yml/badge.svg"/> </a> </p> <br> <p align="center"> harpy is no longer in active development after Twitter's decision to disallow third party Twitter clients. </p> <p align="center"> harpy was available in the Play Store as a free and paid app and was used by over 75.000 active users. </p> <br> <p align="center"> Check out a walkthrough of the app on youtube <a href="https://www.youtube.com/watch?v=egpQsNxLwvU" target="_blank">here</a> </p> <br> <p align="center"> <kbd><img height="480" src="media/login_screen.gif"/></kbd> <kbd><img height="480" src="media/setup_screen.gif"/></kbd> </p> <details> <summary>More images</summary>| Home | Media timeline | Theme selection |
|---|---|---|
| <kbd><img src="media/timeline.jpg"/></kbd> | <kbd><img src="media/media_timeline.jpg"/></kbd> | <kbd><img src="media/theme_selection.jpg"/></kbd> |
| Menu | Trends | Tweet search filter |
| <kbd><img src="media/drawer.jpg"/></kbd> | <kbd><img src="media/trends.jpg"/></kbd> | <kbd><img src="media/tweet_search_filter.jpg"/></kbd> |
About
harpy is an alternative Twitter client that focuses on a nice user experience with unique features.
This project has been in development since late 2018 and aims to be a good example for a medium-large sized Flutter app with a focus on code quality and maintainability.
Some interesting features of the app include:
- riverpod
- for state management using the included state_notifier
- for dependency injection / service locators with easily mockable dependencies
- go_router for routing with support for Twitter url deeplinks
- sentry as an online error tracking service to report unhandled exceptions
- Fully featured theme customization
- Fully featured video player using the video_player package
- My own twitter_api package to make use of the official Twitter api
- A 'pro' and 'free' android product flavor
- Many customized animations sprinkled around the app, including custom logo animations created with Rive
Development / Setup
Follow the project setup for building harpy instructions to get the project running.