Bibliungo

Bibliungo is a platform for avid readers in a locality to share and exchange books with each other. The app scans for other users in your vicinity who are searching for second hand books to buy or exchange. On finding a match, you will be given their contact information after which you may meet up IRL for your new book and hopefully a new friend!

Pre-requisites

• Android SDK v28
• Android Build Tools v28.0.0
• Android Support Repository v23.3.

These components can be downloaded bundled at the Android studio IDE

Tech Stack

• Java
• Android SDK
• Firebase SDK
• Google API
• regex algorithm

Libraries Used

• Architecture Components
• CustomFloatingActionButton
• DebugDB
• Dexter
• Firebase-Firestore
• Firebase-Storage
• Firebase-UI
• Glide
• GSON
• MaterialDrawer
• Logger

Screenshots

Login Screen

Home Screen

Map View

Upload Book

Search Screen

Profile View

Workflow of app

bibliungo
 ┣ activities
 ┃ ┣ AddBookActivity.java
 ┃ ┣ LoginActivity.java
 ┃ ┣ MainActivity.java
 ┃ ┣ MapsActivity.java
 ┃ ┣ ProfileActivity.java
 ┃ ┣ SearchView.java
 ┃ ┗ showBookActivity.java
 ┣ adapter
 ┃ ┗ UserUploadedAdapter.java
 ┗ utils
 ┃ ┣ ActivityUtils.java
 ┃ ┣ BookUtils.java
 ┃ ┣ UserUploaded.java
 ┃ ┗ UserUtils.java

Setting up your development environment

• Download and install Git

• Fork the Bibliungo

• Clone your fork of the project locally. At the command line:

  $ git clone https://github.com/YOUR-GITHUB-USERNAME/Bibliungo

• To build this project, use the gradlew build command

If you prefer not to use the command line, you can use Android Studio to create a new project from version control using

https://github.com/YOUR-GITHUB-USERNAME/Bibliungo

and use Import Project in Android Studio to build it

If there are any missing dependencies, install them first by clicking on the links provided by Android studio. Once the project is built successfully, run the project by clicking on the green arrow at the top of the screen.

PR Instruction

This project uses Travis CI for checking pull requests. So before committing your changes, open Terminal via android studio and run the following commands:

For Windows:

• gradlew clean then
• gradlew assembleDebug assembleRelease then
• gradlew check then
• gradlew build finally
• gradlew spotlessCheck

You can freely contribute to the project on the note that ‘contributing guidelines’ of the project are followed. New ideas and suggestions are welcomed. Happy Coding :)