Skip to content

A flutter app where users can exchange books within their nearby location range.

License

Notifications You must be signed in to change notification settings

Sayam06/Flutter-UI

 
 

Repository files navigation

Hacktober

Explr

App Logo


The project is for all book lovers who want to find other book lovers to either exchange books, discuss about books or get to know people who have similar preference when it comes to reading.

📝 Table of Contents

🎯 Aim

  • Our project aims at providing a platform for users where they can know what their friends are reading and exchange books with them, along with knowing which book is the talk of the town, and we mean it literally.
  • Our project will provide users the service of knowing what is the most read and exchanged books in their desired radius. This is what we mean by knowing what is the talk of the town.
  • In the future, we want our project to be used by people ranging from hardcore bibliophiles searching for a book they want to read in their locality to university students searching for other students for exchanging their course books.
  • Our horizon is not limited as we want to reach each and every one.

💥 Screenshots (Old)




⛏️ Built With

🍰 How to contribute

Step 1: Fork this repository

  • A fork will create a copy of this repository in your GitHub account.

fork howto

Step 2: Clone the repository

  • Cloning will create the copy of the forked repository in your local machine.
  • Copy the URL from here.

clone

  • Open Git Bash or terminal and run the following command:
git clone https://github.com/<Your GitHub Username>/Flutter-UI.git

Step 3: Create a branch:

  • Creating your own branch separates your changes with main branch. For example, if things go wrong or you are not satisfied with them, then you can delete your branch and the main project won't be affected.

Navigate to the folder where the repository is cloned, which will be named Flutter-UI.

Now, in the terminal, create a branch in Git using the following command:

git checkout -b <hacktober/your-first-name>

Use the same name in the branch created in GitHub.

Step 4: Make necessary changes and commit

  1. Open the project in Android Studio or VS Code(recommended) and make sure that you are on the branch created by you, not on main.
  2. Make the changes on the concerned files in order to implement a feature you want to add or resolve an issue.
  3. After you are satisfied with your changes, you can add these changes by using the command:
git add <file names>
  1. Pull the changes from the upstream repo using the command:
git pull upstream main
  1. Then commit these changes using the command:
git commit -m'<Relevant commit message>'

Step 5: Push changes

Push your changes using the command:

git push origin <hacktober/your-first-name>

Step 6: Make a Pull request

Go to your forked GitHub repository, you will see a Compare & pull request button. Click on it. make pr

Please read CONTRIBUTING for details on our CODE OF CONDUCT, and the process for submitting pull requests to us as mentioned above.

🎈 1st Release Features

Features to be implemented:

  • Facebook/Email Authentication
  • User Library
  • Adding Bookmarks
  • Getting books within a location range
  • Themes
  • App Terms and Conditions
  • Auto-generated mail after the exchange
  • Book Recommendations via ML
  • Manually changing the location.

🚩 Further Project Details

⚡ Flutter Resources

🙏 Show your support

⭐️ this repository if you liked our work!


About

A flutter app where users can exchange books within their nearby location range.

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Dart 99.1%
  • Other 0.9%