Thank you for considering contributing to Openreads! Your involvement helps make this app better for everyone. Please take a moment to review this document to understand how you can contribute.
Openreads is a free, open-source app designed to track read books with connection to Open Library. Our goal is to provide a privacy-respecting environment for users with no ads and no user tracking.
We welcome various contributions, including code submissions, bug reports, feature requests, translations on Weblate, and participation from learners seeking issues to implement.
- Create a fork and a branch for your contribution.
- Follow the Angular commits convention. Examples include:
feat: add new featurefix: resolve a bugchore: update dependencies
- Ensure your commits are atomic and have clear messages.
- Submit a pull request of the "rebase and merge" type.
- Ensure the pull request's pipeline is passing.
After you have installed Flutter, then you can start this app by typing the following commands:
flutter pub get
flutter runEnsure that your code follows the Dart formatting conventions. Use the dart format lib command from the root of your repo to format your code.
Currently, there are no tests in the project, but contributions adding tests are welcome.
Go to Openreads on Weblate and translate the app to the languages you know, You can also vote on other suggestions.
Use the following template when submitting a bug report: Bug report template
Use the following template when submitting a feature request: Feature request template
Decisions are typically made by the project owner. The most important ones are discussed before in the Feature Request issue or in our Matrix chat when we can create polls.
If you have any questions or need clarification, ping the maintainer in the PR or ask in the Matrix channel.
Thank you for your contributions to Openreads!