An open source, cross-platform Lemmy client built with Flutter
Contributing • Building From Source • Conventions • Related Packages
Hey there! Just wanted to let you know that this repo is currently my personal side project to build something cool while learning about Dart and Flutter.
As the sole maintainer of this project, progress might be a bit slow. But hey, here's where you can make a difference! Whether you're proficient at Flutter and Dart, or just simply interested in the project, I would be absolutely thrilled if you could lend a hand and contribute.
Your passion, contributions, and ideas would be greatly appreciated! Together, let's make this project shine. 🚀 💻
Note: As this is still in alpha and WIP, releases will happen through GitHub. There are no plans at the moment to release to Google Play store (and derivatives) or Apple's TestFlight. However, this may change in the future as more progress is made.
All releases will be held in the Releases section under the corresponding version.
- For iOS users, you can install Thunder using AltStore
- For Android users, simply install Thunder with the provided APK file.
Thunder is currently undergoing active development, and it is possible that not all features have been fully implemented at this stage. Due to this, significant breaking changes may occur between versions. The next section summarizes the features that are currently implemented.
- Browse community posts
- Search for communities from the current instance (and subscribe)
- Browse subscriptions if logged in
- Voting and saving for posts and comments
- See a specific post and its associated comments
- Infinite scrolling for posts
- Infinite scrolling for comments
- Multi-account login and switching
- Basic settings to change the view of posts on a given community/feed
- Light and dark themes available
The current focus is to provide a MVP to be able to do basic tasks, including
- Ability to create posts and comments
- Improvements to accessibility
- Improvements to customizability of post views (compact, normal, expanded, etc)
Contributions are always welcome! To contribute potential features or bug-fixes:
- Fork this repository
- Apply any changes and/or additions based off an existing issue (or create a new issue for the feature/fix you are working on)
- Create a pull request to have your changes reviewed and merged
Thunder is developed with Flutter, and is built to support both iOS and Android.
To build the app from source, a few steps are required.
- Set up and install Flutter.
- For more information, visit https://docs.flutter.dev/get-started/install.
- Clone this repository and fetch the dependencies using
flutter pub get - Run the build script using
dart scripts/build.dart, which will build both the iOS and Android release versions
While there are no specific conventions that must be followed, do try to follow best practices whenever possible.
Suggestions are always welcome to improve the code quality and architecture of the app!
Thunder uses the following packages and libraries under the hood. This is not an exhaustive list.
lemmy-dart - custom-built Lemmy library built in Dart