Skip to content

alsaidmandor/bazar

Repository files navigation

Bazar - Book Booking App

Flutter License PRs

Overview

Bazar is a Flutter application for booking and managing books. The app allows users to browse available books, reserve them, and manage bookings. It also integrates Google Maps for location-based services and Firebase Cloud Messaging (FCM) for notifications.

App Logo

App Logo

Features

  • Browse a wide selection of books.
  • Search for books by title, author, or genre.
  • Book a book with an easy-to-use interface.
  • Get notified when your book is ready via Firebase Cloud Messaging.
  • Integrated Google Maps to find bookstores nearby.

Design

You can view the app design on Figma: Bazar - Books Mobile App

Screenshots

Add screenshots of your app here for a visual overview.

Splash Screen Onboarding 1 Onboarding 2 Onboarding 3
Splash Screen Onboarding 1 Onboarding 2 Onboarding 3
Login Screen SignupScreen 1 SignupScreen 2 SignupScreen Phone
Login Screen SignupScreen 1 SignupScreen 2 SignupScreen Phone
VerificationPhone Screen SuccessVrification Screen FeedScreen 1 FeedScreen 2
VerificationPhone Screen SuccessVrification Screen FeedScreen 1 FeedScreen 2
FeedScreen 3 BookDetails Screen AuthorsScreen 1 AuthorsScreen 2
FeedScreen 3 BookDetails Screen FeedScreen 1 FeedScreen 2
Search screen Loading Search Screen AuthorsDetails Screen CategoryScreen Loading
Search screen Loading Search Screen AuthorsDetails Screen CategoryScreen Loading
All Category Screen Love Category Screen Profile Screen Update Profile Screen
All Category Screen Love Category Screen Profile Screen Update Profile Screen

Getting Started

Follow these instructions to set up and run the project on your local machine.

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/alsaidmandor/bazar.git
    cd bazar
  2. Install dependencies:

    flutter pub get
  3. Set up Firebase:

    • Go to Firebase Console.
    • Create a new project.
    • Download google-services.json and add it to android/app/.
  4. Configure Google Maps:

    • Obtain a Google Maps API key from the Google Cloud Console.
    • Add the API key to android/app/src/main/AndroidManifest.xml under <application> tag:
      <meta-data
         android:name="com.google.android.geo.API_KEY"
         android:value="YOUR_API_KEY"/>
  5. Run the app:

    flutter run

Folder Structure

Here’s a brief explanation of the folder structure:

├── lib
│   ├── core
│   │   ├── helper
│   │   ├── networking
│   │   ├── routing
│   │   ├── theme
│   │   ├── utils
│   │   ├── widgets
│   ├── Feature
│   │   ├── authentication
│   │   ├── cart
│   │   ├── category
│   │   ├── feed
│   │   ├── home
│   │   ├── onboarding
│   │   ├── profile
├── generated
├── res
│   ├── bazar_app.dart
│   ├── bloc_observer.dart
│   ├── firebase_options.dart
│   ├── main_development.dart
│   ├── main_production.dart      

Contributing

Feel free to fork this repository and contribute by submitting a pull request. All contributions are welcome!

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact