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.
- Project Components
- Features
- Design
- Tech Stack
- Architecture
- Requirements
- Installation
- Usage
- Contributors
- License
-
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.
- 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.
- 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.
- 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.
- Discover Honey Mart Design on Figma.
- Recommended Architecture
- Jetpack Compose
- Hilt dependency injection
- Data Store
- MVVM
- Coroutines
- StateFlow
- Ktor Client
- Kotlin DSL
- App Modularization
This project uses MVVM (Model View View-Model) with the recommended architecture and contains multi modules as shown.
Before you begin, ensure you have met the following requirements:
-
Android Studio with Jetpack Compose support:
-
Firebase Project:
-
Connection to honey-mart server:
- Clone the repository:
git clone https://github.com/yourusername/honey-mart-android-client.git cd honey-mart-android-client - Add Firebase Json file for User, Owner and admin apps.
- Add Api-Key named as "apiKey" to the local.properties file.
- To test the APPs, there is an APKs build here that you can directly download and install.
Copyright (c) 2023 The Chance
- This project is licensed under the Apache License 2.0 - see the LICENSE file for details.