Skip to content

AadityaHande/Farm2Ghar-next

BranchesTags

Repository files navigation

Farm2Ghar - Direct from Farm to Home 🌾

Status: 95% Production Ready | Last Updated: November 25, 2025

A modern D2C agricultural marketplace connecting farmers directly with consumers, powered by AI and built with Next.js 15 + Firebase + Google Gemini.

🎯 What's Working Right Now

✅ Complete Features

  • Authentication: Google Sign-In + Phone OTP + Demo Mode
  • Role-Based Dashboards: Farmer, Buyer, Admin views
  • Product Management: Full CRUD with real-time Firestore sync
  • Shopping Cart: Real-time updates with localStorage persistence
  • Order System: End-to-end order creation and tracking
  • Notifications: Real-time notifications with unread count
  • Order Status Updates: 4-stage workflow (Placed → Confirmed → Preparing → Delivered)
  • Profile Management: Edit name, phone, email, addresses
  • Search & Browse: Category filters, search by name
  • AI Integration: Photo-based grading, voice listings (Google Gemini)

🔧 Known Issues

See REMAINING_ISSUES.md for complete list of:

  • Minor bugs to fix
  • Features in progress
  • Performance optimizations needed
  • Security improvements required

🌟 Features

For Buyers

  • Browse Fresh Produce - AI-graded vegetables, fruits & more
  • Smart Search - Find exactly what you need
  • Real-time Cart - Instant Firestore sync
  • Secure Checkout - Multiple payment options
  • Order Tracking - Live delivery updates
  • Reviews & Ratings - Share your experience

For Farmers

  • Multiple Listing Options:
    • 📝 Text Form - Manual entry with all details
    • 📸 Photo Upload - AI-powered grading
    • 🎤 Voice Input - Speak your details (Web Speech API)
    • 💬 WhatsApp - List via message
  • Smart Dashboard - Real-time earnings & inventory
  • AI Grading - Google Gemini analyzes photos
  • Bulk Upload - Create multiple SKUs instantly

Technology

  • ⚡ Next.js 15.3 - React 19 with Turbopack
  • 🔥 Firebase - Firestore + Storage + Auth
  • 🤖 Google Gemini - Real AI (not simulated)
  • 📱 PWA - Installable on mobile/desktop
  • 🎨 Tailwind CSS - Beautiful, responsive UI
  • 📲 Capacitor - Native Android/iOS builds

🚀 Quick Start

Prerequisites

  • Node.js 18+
  • Firebase account
  • Google AI API key

Installation

# Clone repository
git clone https://github.com/AadityaHande/Farm2Ghar-next.git
cd Farm2Ghar-next

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your Firebase & Google AI credentials

# Start development server
npm run dev

Visit http://localhost:9002

Firebase Setup

# Login to Firebase
firebase login

# Deploy security rules
firebase deploy --only firestore:rules

# Deploy indexes
firebase deploy --only firestore:indexes

Seed Sample Data

Visit http://localhost:9002/api/seed in your browser to add 8 sample products.

📱 PWA Installation

  1. Open the app in a browser
  2. Wait 3 seconds for the install prompt
  3. Click "Install Now"
  4. App installs to home screen

Smart Detection: Prompt won't show if already installed or dismissed.

🎯 Create Listing Options

1. Text Form (/create-listing/text)

  • Complete manual entry form
  • All fields: name, category, grade, price, stock, harvest date
  • Instant Firestore creation

2. Photo Upload (/create-listing/photo)

  • Upload produce image
  • AI analyzes quality & grade
  • Suggests price based on market data
  • Creates 3 SKUs (250g, 500g, 1kg)

3. Voice Input (/create-listing/voice)

  • Web Speech API integration
  • Speak: "I have tomatoes, 50 rupees per kg, 20 kg stock"
  • AI extracts details
  • Creates listing

4. WhatsApp (/create-listing/whatsapp)

  • Send message to support number
  • Team creates listing within 15 minutes
  • Works offline

🏗️ Project Structure

Farm2Ghar-next/
├── src/
│   ├── app/              # Next.js pages & API routes
│   │   ├── (main)/       # Protected routes
│   │   │   ├── home/     # Buyer & Farmer dashboards
│   │   │   ├── create-listing/  # All 4 listing methods
│   │   │   ├── orders/   # Order management
│   │   │   └── profile/  # User settings
│   │   ├── api/          # Backend endpoints
│   │   │   ├── seed/     # Database seeding
│   │   │   └── orders/   # Order creation
│   │   └── page.tsx      # Homepage (role selection)
│   ├── components/       # Reusable React components
│   │   ├── home/         # Dashboard components
│   │   ├── listings/     # Product cards
│   │   ├── shared/       # Header, Nav, FAB
│   │   └── ui/           # shadcn/ui components
│   ├── firebase/         # Firebase config & hooks
│   ├── ai/               # Google Gemini integration
│   │   ├── genkit.ts     # AI configuration
│   │   └── flows/        # 4 AI-powered flows
│   └── lib/              # Utilities & helpers
├── public/               # Static assets
│   ├── manifest.json     # PWA configuration
│   ├── sw.js             # Service worker
│   ├── icon-192.png      # PWA icon (192x192)
│   └── icon-512.png      # PWA icon (512x512)
├── docs/                 # Documentation
│   ├── FEATURES.md       # Complete feature list
│   ├── DEPLOYMENT.md     # Production deployment guide
│   └── QUICKSTART.md     # Getting started
├── scripts/              # Automation scripts
├── firestore.rules       # Security rules (demo mode enabled)
├── firestore.indexes.json # Query indexes
└── firebase.json         # Firebase configuration

🔐 Demo Mode

App works without Firebase authentication:

  • UserIds: demo-buyer-{timestamp} or demo-farmer-{timestamp}
  • Full CRUD operations enabled
  • Firestore rules allow demo users
  • Perfect for testing & hackathons

🎨 UI/UX Highlights

  • No Emojis - Professional Lucide React icons only
  • Gradients - Beautiful green/emerald color scheme
  • Animations - Smooth transitions & hover effects
  • Responsive - Mobile-first design
  • Accessibility - ARIA labels & keyboard navigation

📊 Available Scripts

npm run dev              # Start development server (Turbopack)
npm run build            # Production build
npm run start            # Start production server
npm run typecheck        # TypeScript validation
npm run lint             # ESLint

# Capacitor (Mobile)
npm run cap:add          # Add platform (android/ios)
npm run cap:sync         # Sync web code to native
npm run cap:android      # Open Android Studio

# Firebase
firebase:deploy          # Deploy rules & indexes
firebase:setup           # Initial Firebase setup

# Production
npm run production:build # Full build + Capacitor sync
npm run production:deploy # Complete deployment

🤝 Contributing

This is a hackathon submission project. Contributions welcome!

📄 License

MIT License - See LICENSE file

🙏 Acknowledgments

  • Team Varchasva - Aaditya Hande & Aditya Suryawanshi
  • Google Gemini - AI-powered grading
  • Firebase - Backend infrastructure
  • Vercel - Deployment platform
  • shadcn/ui - Component library
  • Lucide - Icon system

Built with ❤️ for farmers and consumers

Demo: farm2ghar.vercel.app GitHub: AadityaHande/Farm2Ghar-next - Direct Farm-to-Consumer Marketplace

Farm2Ghar revolutionizes the agricultural supply chain by connecting farmers directly with consumers, eliminating middlemen and ensuring fair prices for farmers while providing fresh produce to buyers.

Problem Statement

Traditional agricultural supply chains involve multiple intermediaries, resulting in:

  • Farmers receiving only 20-30% of the final retail price
  • Consumers paying inflated prices for produce
  • Quality degradation during long transit times
  • Lack of transparency in pricing and sourcing

Our Solution

Farm2Ghar is a Direct-to-Consumer (D2C) mobile-first platform that:

  • Enables farmers to list and sell produce directly to consumers
  • Uses AI to grade produce quality and suggest optimal pricing
  • Provides real-time inventory management for farmers
  • Offers consumers fresh produce at fair prices with full traceability
  • Features voice and photo-based listing creation for easy farmer onboarding

Key Features

For Farmers

  • AI-Powered Listing Creation: Upload produce photos, AI grades quality (A/B/C) and suggests pricing
  • Voice-Based Listings: Create listings using voice commands in local languages
  • Real-Time Dashboard: Track earnings, inventory, and orders
  • Bulk Upload: List multiple products efficiently
  • Direct Payments: Receive payments directly without intermediaries

For Buyers

  • Fresh Produce Marketplace: Browse high-quality farm-fresh products
  • Smart Cart: Real-time stock updates and price calculations
  • Order Tracking: Track orders from farm to doorstep
  • Quality Assurance: AI-graded produce with transparency scores
  • Direct Communication: Connect with farmers for special requests

AI Features (Powered by Google Gemini 2.5)

  • Photo-Based Grading: Analyze produce images for quality, freshness, and defects
  • Smart Pricing: Suggest optimal prices based on quality, season, and market data
  • Krishi AI Assistant: Conversational AI for farming tips and support
  • Voice Recognition: Convert speech to structured product listings

Technology Stack

Frontend

  • Next.js 15.3 - React framework with App Router
  • TypeScript - Type-safe development
  • Tailwind CSS - Modern, responsive UI
  • Lucide Icons - Professional icon library
  • Shadcn UI - High-quality component library

Backend & Database

  • Firebase Firestore - Real-time database
  • Firebase Storage - Image and media storage
  • Firebase Authentication - Secure user management

AI & Machine Learning

  • Google Gemini 2.5 Flash - Advanced AI model
  • Genkit - AI framework for TypeScript
  • Image Analysis - Quality grading and defect detection
  • Speech Recognition - Voice-to-text conversion

Mobile

  • Capacitor 7 - Native iOS/Android wrapper
  • PWA Support - Installable web app
  • Offline Capabilities - Works without constant connectivity

Getting Started

Prerequisites

Node.js 18+
npm or yarn
Firebase account
Google AI API key

Installation

  1. Clone the repository:
git clone https://github.com/AadityaHande/Farm2Ghar-next.git
cd Farm2Ghar-next
  1. Install dependencies:
npm install
  1. Set up environment variables:
cp .env.example .env

Add your credentials to .env:

NEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_project.appspot.com
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id

GOOGLE_GENAI_API_KEY=your_google_ai_key
  1. Run development server:
npm run dev

Open http://localhost:9002 in your browser.

Building Mobile Apps

Android

npm run cap:sync
npm run cap:android

iOS

npm run cap:sync
npm run cap:ios

Core Workflows

Farmer Journey

  1. Sign up as a farmer
  2. Upload produce photo (AI grades quality automatically)
  3. Review AI suggestions for pricing and packaging
  4. Publish listing to marketplace
  5. Receive orders and manage fulfillment
  6. Track earnings and inventory in real-time

Buyer Journey

  1. Browse fresh produce with quality grades
  2. Add items to cart with live stock updates
  3. Checkout with address selection
  4. Track order status from farm to doorstep
  5. Receive notifications at each milestone
  6. Rate and review products

Testing

We've implemented comprehensive testing across:

  • User authentication flows (demo mode + Firebase)
  • Product listing and inventory management
  • Order creation and tracking
  • Cart synchronization
  • AI grading accuracy
  • Mobile responsiveness

Test the app:

# Login as Farmer (Demo Mode)
Email: [email protected]
Password: demo123

# Login as Buyer (Demo Mode)
Email: [email protected]
Password: demo123

Business Impact

For Farmers

  • 70% increase in profit margins by removing middlemen
  • Real-time payments instead of 30-90 day credit cycles
  • Market insights through AI-powered analytics
  • Direct customer relationships for repeat business

For Consumers

  • 30% lower prices compared to retail stores
  • Farm-to-table freshness (24-48 hour delivery)
  • Full transparency on sourcing and quality
  • Support local farmers directly

Security & Privacy

  • End-to-end encryption for transactions
  • Secure Firebase Authentication
  • PCI-compliant payment processing
  • GDPR-compliant data handling
  • Role-based access control

Future Roadmap

  • Subscription Model: Weekly produce boxes
  • Cooperative Farming: Connect farmers for bulk orders
  • Cold Chain Integration: Expand to dairy and meat
  • AI Crop Advisory: Predict harvest times and yields
  • Blockchain Traceability: Immutable supply chain records
  • Multi-language Support: Regional language interfaces

Our Approach

Our development focused on:

  • User-Centric Design: Conducted farmer interviews for UX insights
  • AI-First: Leveraged Google Gemini for intelligent automation
  • Mobile-First: Built for smartphone users (farmers + buyers)
  • Scalable Architecture: Firebase for real-time sync and scalability
  • Rapid Prototyping: Iterative development with continuous feedback

Project Structure

src/
├── app/                    # Next.js pages and routes
│   ├── (main)/            # Main app with navigation
│   │   ├── home/         # Role-specific dashboards
│   │   ├── create-listing/ # AI-powered listing creation
│   │   ├── listings/     # Product marketplace
│   │   ├── orders/       # Order management
│   │   ├── advisor/      # Krishi AI assistant
│   │   └── profile/      # User profiles
│   └── login/            # Authentication
├── ai/                    # AI flows and Genkit config
│   ├── flows/            # Voice, photo, negotiation AI
│   └── genkit.ts         # Google Gemini setup
├── components/            # Reusable UI components
├── firebase/              # Firebase configuration
└── lib/                   # Utilities and helpers

Available Scripts

# Development
npm run dev              # Start Next.js dev server
npm run genkit:dev       # Start Genkit AI dev UI

# Building
npm run build            # Production build
npm run typecheck        # TypeScript validation

# Mobile Apps
npm run cap:sync         # Sync web → native
npm run cap:android      # Open Android Studio
npm run cap:ios          # Open Xcode

# Firebase
npm run firebase:setup   # Initialize Firebase
npm run firebase:deploy  # Deploy rules & indexes
npm run firebase:seed    # Add sample data

# Production
npm run production:build    # Full build pipeline
npm run production:deploy   # Complete deployment

Team

Team Varchasva

Built by:

  • Aaditya Hande - @AadityaHande
  • Aditya Suryawanshi - Full Stack Development & AI Integration

Contact

For questions or collaboration:

Built with ❤️ by Team Varchasva for farmers and conscious consumers

About

farm2-ghar-next.vercel.app

Resources

Readme
Activity

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages