🌾 AgriBridge — Farm-to-Consumer Mobile App

A Flutter mobile shopping application connecting farmers directly to consumers. Browse fresh vegetables and lifestyle products, manage your cart, and register as a vendor — all in one app.

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        AgriBridge App                           │
│                                                                 │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                    Presentation Layer                     │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────┐  │   │
│  │  │ HomePage │ │ Products │ │   Cart   │ │  Checkout  │  │   │
│  │  │          │ │ + Search │ │  Screen  │ │   Screen   │  │   │
│  │  └──────────┘ └──────────┘ └──────────┘ └────────────┘  │   │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐                 │   │
│  │  │ Profile  │ │  Vendor  │ │ Contact  │                 │   │
│  │  │  Screen  │ │   Form   │ │  Screen  │                 │   │
│  │  └──────────┘ └──────────┘ └──────────┘                 │   │
│  └──────────────────────────────────────────────────────────┘   │
│                              │                                   │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                   State Management                        │   │
│  │  ┌──────────────┐  ┌──────────────┐  ┌───────────────┐   │   │
│  │  │ CartProvider  │  │  Favorites   │  │ AuthProvider   │   │   │
│  │  │ (add/remove)  │  │   Provider   │  │ (Firebase)     │   │   │
│  │  └──────────────┘  └──────────────┘  └───────────────┘   │   │
│  └──────────────────────────────────────────────────────────┘   │
│                              │                                   │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │                     Data Layer                            │   │
│  │  ┌──────────────┐  ┌──────────────┐                      │   │
│  │  │ Product Model│  │  CartItem    │                      │   │
│  │  │  + Data      │  │   Model     │                      │   │
│  │  └──────────────┘  └──────────────┘                      │   │
│  └──────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────┘
                              │
                       Firebase Backend
                 (Auth · Firestore · Storage)

📂 Project Structure

Agribridge/
├── .github/workflows/dart.yml  # Flutter CI pipeline
├── .env.example                # Firebase config template
├── pubspec.yaml                # Flutter dependencies
├── lib/
│   ├── main.dart               # App entry point + Provider setup
│   ├── firebase_options.dart   # Firebase configuration
│   ├── data/
│   │   └── product_data.dart   # Centralized product catalog
│   ├── models/
│   │   ├── product.dart        # Product model with copyWith
│   │   └── cart_item.dart      # Cart item model with copyWith
│   ├── providers/
│   │   ├── auth_provider.dart  # Authentication state
│   │   ├── cart_provider.dart  # Shopping cart state
│   │   └── favorites_provider.dart
│   ├── screens/
│   │   ├── main_screen.dart    # Bottom navigation host
│   │   ├── home_page.dart      # Landing page with categories
│   │   ├── product_list_screen.dart  # Product grid + search
│   │   ├── cart_screen.dart    # Cart management
│   │   ├── checkout_screen.dart
│   │   ├── profile_screen.dart
│   │   ├── contact_screen.dart
│   │   ├── vendor_form_screen.dart
│   │   └── vendor_opportunities_screen.dart
│   └── widgets/
│       └── floating_cart_button.dart
├── android/
├── ios/
├── web/
└── test/

🚀 Getting Started

Prerequisites

• Flutter SDK ≥ 3.0.0
• Dart SDK ≥ 3.0.0
• Android Studio or VS Code with Flutter extension
• Firebase project (for auth & database)

Setup

# 1. Clone the repository
git clone https://github.com/silapareddy/Agribridge.git
cd Agribridge

# 2. Install dependencies
flutter pub get

# 3. Configure Firebase
# Copy .env.example and fill in your Firebase credentials
# Then update lib/firebase_options.dart with your values
# See: https://console.firebase.google.com/

# 4. Run the app
flutter run

Environment Variables

Variable	Description	Where to find
FIREBASE_API_KEY	Firebase API key	Firebase Console → Project Settings
FIREBASE_APP_ID	Firebase App ID	Firebase Console → Project Settings
FIREBASE_PROJECT_ID	Firebase Project ID	Firebase Console → Project Settings
FIREBASE_AUTH_DOMAIN	Auth domain	{project-id}.firebaseapp.com
FIREBASE_STORAGE_BUCKET	Storage bucket	{project-id}.appspot.com

✨ Features

• 🛒 Shopping Cart — Add/remove products with quantity management
• 🔍 Product Search — Filter products by name or description in real-time
• 📋 Product Categories — Browse Vegetables and Lifestyle products
• 🧑‍🌾 Vendor Registration — Form with validation for farmer onboarding
• 👤 Profile Management — User profile and purchase history
• 📱 Responsive UI — Material Design 3 with green agricultural theme

🧰 Tech Stack

Technology	Purpose
Flutter 3.22	Cross-platform UI framework
Dart 3.x	Programming language
Provider	State management
Firebase Auth	User authentication
Cloud Firestore	NoSQL database
cached_network_image	Image caching
GitHub Actions	CI/CD pipeline

📸 Screenshots

Home Page	Products	Cart	Vendor Registration