A simple booktracker app as an introduction to flutter-app development, and contribution to opensource projects.
Hacktoberfest is a month-long celebration of open source software run by DigitalOcean. During the month of October, you are invited to join open-source software enthusiasts, beginners, and the developer community by contributing to open-source projects.
Git Set Code is an event by Google Developer Student Club JSSSTU, Mysuru, which aims to ease the open source journey of a developer. This session provides a hands-on experience of Git encouraging people to participate in open source contribution and community events.
The base project is a bare-bones library book tracker app where you can only add and view books that you have borrowed.
Tech stack used: Flutter, sqlite (backend)
- Flutter
- SQLite
-
To get all dependencies use:
flutter pub get -
To run the project use:
flutter run
Click here for the UI design and prototype of the project.
Intended Final Project: A functional library book tracker in which you can add, remove, edit and view books, and get a reminder after 2 weeks to return them. This is not a library management system, but it is a personal reminder app.
The issues tab on our GitHub repo serves as a list of features that are necessary or in-demand and a list of bugs that need to be fixed. Feel free to pick up an issue and work on it, but before you do so, please comment on the respective issue which you want to work on with the details on how you want to approach the issue, so that we can assign you the issue. You can also add more issues on the list as a form of feature request, or to present a bug in our app.
- A GitHub account
- git CLI
Please refer to each project's style and contribution guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow.
-
Fork the repo on GitHub
By forking a repository you create your own copy of the project onto your GitHub account and make your changes there.
-
Clone the project to your own machine
Cloning a project means that you are setting up the project on your local system.
Please follow the given naming convention for naming the branch after forking:
<issue-type>/<issue-name-in-short>For example, for the issue #6, the branch name would be
enhancement/dark-theme-toggle -
Keeping your own forked repo in sync with the main repo
Sync a fork of a repository to keep it up-to-date with the upstream repository.
-
Commit changes to your own branch
Committing means making changes to the project and adding your changes to GitHub.
-
Push your work back up to your fork
Pushing is how you transfer commits from your local repository to a remote repo.
-
Submit a Pull request so that we can review your changes
Pull request means submitting your changes to the original project for the review. Once the maintainers of the project feel that your changes are appropriate then your pull request will be merged.
Be sure to merge the latest from "upstream" before making a pull request and resolve all merge conflicts! Read more about resolving merge conflicts here.