ShambaShop

A mobile application connecting farmers and customers for direct agricultural commerce.

Description

ShambaShop is an Android application that provides a platform for farmers to list their agricultural products and for customers to browse, purchase and manage their orders. The app streamlines the buying and selling process with features for product management, cart management and order tracking.

Features

• User Authentication: Secure login and registration for both farmers and customers
• Product Management: Farmers can list and manage products
• Browse & Purchase: Customers can browse available products and add items to cart
• Cart Management: Manage items in cart with easy checkout
• Order History: Track past orders and purchases
• Farmer Dashboard: Manage products, view sales, and generate reports
• Customer Dashboard: View profile, orders, and purchase history
• Reports: View sales analytics and reports

Tech Stack

• Language: Java
• Framework: Android
• Build Tool: Gradle
• Backend: Firebase
• UI: XML layouts with Material Design components

Installation

Prerequisites

• Android Studio (Latest version)
• JDK 11 or higher
• Android SDK 24 or higher

Setup

1. Clone the repository:

   git clone https://github.com/yourusername/ShambaShop.git
   cd ShambaShop

2. Open the project in Android Studio

3. Add Firebase configuration:

   • Place your google-services.json file in the app/ directory

4. Sync Gradle files:

   ./gradlew build

5. Run the app:

   ./gradlew installDebug

Project Structure

app/
├── src/
│   ├── main/
│   │   ├── java/com/example/shambashop/  # Application code
│   │   └── res/                           # Resources (layouts, drawables, etc.)
│   └── androidTest/                       # Instrumented tests
└── build.gradle                           # Module-level build configuration