BookApp is a cross-platform mobile application developed using Flutter. It allows users to access a wide range of books, both offline and online, with features such as search, bookmarking, preview mode, and more. This README.md file provides detailed information about the app, its features, setup instructions, and collaborators.
This project is a starting point for a Flutter application.
A few resources to get you started if this is your first Flutter project:
For help getting started with Flutter development, view the online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.
The app provides a free offline version that users can access without an internet connection. It includes a limited selection of books and allows users to interact with the available content.
The app also offers an online version, which requires an internet connection. This version provides additional features and access to a wider range of books. Users can browse, search, and purchase books directly from the app.
The app includes a search bar that allows users to filter available books based on their search input. If a book is not available in the offline free version (i.e., if it's a paid book), a link is provided to redirect users to the appropriate online source.
The app renders an online status flag at the top of the screen, indicating whether the user is currently online or offline. This feature helps users determine their connectivity status while using the app.
The app provides an onboarding screen to guide users through the initial setup and introduce them to the app's features and functionality.
Upon launching the app, users are greeted with a visually appealing splash screen, enhancing the overall user experience.
The main screen of the app displays the available books in a grid view, allowing users to easily browse through and select their desired titles.
The app also has the ability to share books through the share icon to different platforms like WhatsApp, Instagram, a particular person, Facebook, and more.
On click of each book displayed in a category, the app provides a preview of the book, including the name of the author and a detailed description.
The app makes a request to the Google API on load to fetch all the ebooks available in various categories such as coding, art, literature, finance, fiction, and more.
The app has a payment screen to help you purchase paid books and add them to your bookshelf.
The app offers a grid view of sites where you can access free books and a horizontal scroll section of different book categories coming from the API, such as coding, art, fiction, and more. If the book is available on Amazon as a paid book, the Amazon logo is displayed to enable the user to visit the Amazon official site to purchase it.
The app offers a bookmarking feature where you can save any of your preferred books to your shelf.
The app integrates with the Google API to interact with the SQL database, especially in offline mode. It makes a certain number of requests to fetch data from the API, which is stored in the local database for users to access and interact with in offline mode.
The following emails have been added as collaborators to the project:
To install the BookApp on your mobile device, follow these steps:
- Clone the GitHub repository:
git clone https://github.com/chidubesteve/BookApp.git - Navigate to the project directory:
cd BookApp - Install the required dependencies:
flutter pub get - Build the APK file:
flutter build apk - Locate the generated APK file in the
build/app/outputs/flutter-apkdirectory. - Transfer the APK file to your mobile device.
- On your mobile device, navigate to the location where you transferred the APK file and install it.
Note: Ensure that you have Flutter and the necessary development environment set up before proceeding with the installation.
Once you have installed the BookApp on your mobile device, follow these steps to start using it:
- Launch the app from your device's app drawer.
- On the onboarding screen, follow the instructions to set up the app.
- Browse through the available books in the grid view or scroll through the different book categories.
- Use the search bar to filter books based on your preferences.
- Click on a book to view its detailed preview, including the author's name and description.
- Purchase paid books from the payment screen and add them to your bookshelf.
- Share books with others through various platforms using the share icon.
- Bookmark your preferred books to easily access them later.
- Enjoy reading offline or explore more books in the online version.
- Explore different categories and discover new books to expand your reading collection.
For any inquiries, issues, or suggestions regarding the BookApp, please contact one of the collaborators listed above or send an email.
This project is licensed under the MIT License.