Honey Mart Client

Honey Mart is a versatile platform built with Kotlin and Jetpack Compose, where various markets can easily display and sell their products. It provides a user-friendly and engaging online shopping experience.

Table of Contents

• Project Components
• Features
• Design
• Tech Stack
• Architecture
• Requirements
• Installation
• Usage
• Contributors
• License

Project Components

• User Mobile App: The front-facing application designed for customers and shoppers. It offers a user-friendly interface to explore products, add them to the cart, place orders, manage wishlists, and enjoy a seamless shopping experience. Users can create accounts, log in, and access their profiles. They also receive real-time notifications about their orders, making it convenient and engaging for customers.

• Owner Tablet App: The Owner App is tailored for market owners and administrators. It empowers them to manage their respective markets efficiently. Owners can add and update product listings, categorize products, and oversee orders placed within their markets. They also have control over coupon management, and other market-specific tasks. The Owner App streamlines market management and ensures a smooth operation for market owners.

• Admin Tablet App: The Admin App is responsible for market approval management. Administrators use this app to review and approve exciting new markets joining the platform and, if necessary, remove markets that no longer meet the platform's standards. This app streamlines market approval processes and ensures a curated marketplace for users.

Features

User App:

• User Registration and Authentication: Users can create accounts, log in, and access their profiles.
• Browse Products: Browse a wide range of products available at Honey Mart.
• Product Details: View detailed information about each product.
• Add to Cart: Easily add products to your cart for later purchase.
• Order Management: Place and manage orders with ease.
• Wishlist: Add products to your Wishlist for future reference.
• Real-Time Notifications: Receive notifications about order status updates.
• Coupon Redemption: Clip coupons to avail discounts.

Owner App:

• Market Management: Owners can create and manage their markets with ease.
• Product and Category Management: Efficiently manage product listings and categories within their markets.
• Order Tracking: Keep track of orders placed within their markets and update order statuses.
• Coupon Management: Owners can create, distribute, and manage coupons for their markets.
• Real-Time Notifications: Receive alerts about market-related activities and orders.

Admin App:

• Market Approvals: Admins can review and approve new markets wishing to join the platform.
• Market Removal: Admins can remove markets that do not meet platform standards or are no longer active.

Design

• Discover Honey Mart Design on Figma.

🚀 Tech stack

• Recommended Architecture
• Jetpack Compose
• Hilt dependency injection
• Data Store
• MVVM
• Coroutines
• StateFlow
• Ktor Client
• Kotlin DSL
• App Modularization

Architecture

This project uses MVVM (Model View View-Model) with the recommended architecture and contains multi modules as shown.

Requirements

Before you begin, ensure you have met the following requirements:

• Android Studio with Jetpack Compose support:

  • Download Android Studio

• Firebase Project:

  • Create Firebase Project

• Connection to honey-mart server:

  • Honey-Mart-Server

Installation

1. Clone the repository:

      git clone https://github.com/yourusername/honey-mart-android-client.git
      cd honey-mart-android-client

2. Add Firebase Json file for User, Owner and admin apps.
3. Add Api-Key named as "apiKey" to the local.properties file.

Usage

• To test the APPs, there is an APKs build here that you can directly download and install.

Contributors

License

Copyright (c) 2023 The Chance

• This project is licensed under the Apache License 2.0 - see the LICENSE file for details.