# 🌱 HarvestID

AI-Powered Digital Crop Passport & Smart Agriculture Platform

HarvestID — From Seed to Harvest, Every Crop Has an Identity.

HarvestID is a multilingual, AI-powered digital agriculture platform designed to give every registered crop a digital identity and traceable crop passport.

The platform enables farmers to register crops, record field activities, generate digital crop passports, scan and share crop information through QR codes, interact with an AI-powered Farmer Assistant, use voice-based interaction, automatically capture location information, and manage crop information through a farmer-friendly multilingual interface.

HarvestID combines Artificial Intelligence, Digital Crop Traceability, GPS, QR Technology, Voice Interaction, Multilingual Accessibility, and Modern Web Technologies into a single agriculture-focused ecosystem.

---

🚀 Project Overview

Agriculture involves multiple stages between planting and harvesting.

Important information such as:

• Crop variety
• Farm information
• Planting date
• Location
• Area
• Sowing activities
• Irrigation
• Fertilization
• Pest monitoring
• Crop health observations
• Images
• Notes
• Harvest readiness

is often recorded manually or scattered across different systems.

HarvestID addresses this problem by creating a digital identity for every crop.

Each registered crop receives a centralized digital record that can be updated throughout its lifecycle.

The farmer can eventually share this information through a QR-based digital crop passport, making crop information easier to access, understand, and verify.

---

🎯 Objectives

HarvestID is designed to:

• Digitize crop records
• Create a unique identity for every crop
• Maintain crop lifecycle information
• Improve agricultural traceability
• Simplify field activity recording
• Provide AI-powered agricultural assistance
• Support regional languages
• Enable voice-based interaction
• Automatically capture farm/crop location
• Provide QR-based crop information sharing
• Make agricultural data easier to access
• Create a scalable foundation for future smart agriculture services

---

✨ Key Features

🌾 1. Digital Crop Registration

Farmers can register crops digitally instead of maintaining only physical records.

Crop information can include:

• Crop name
• Crop variety
• Category
• Farm name
• GPS location
• Cultivated area
• Crop image
• Notes
• Crop score
• Passport status

Each crop becomes a separate digital record.

---

🪪 2. Digital Crop Passport

Every registered crop can receive a digital crop passport.

The passport acts as the crop's digital identity.

It can contain:

• Crop information
• Farm information
• Crop image
• Location
• Crop score
• Crop lifecycle information
• Recorded field activities
• Passport status
• QR code

The passport can be accessed through a dedicated public URL.

---

📱 3. QR Code Crop Passport

HarvestID provides QR-based access to crop passport information.

Workflow

Register Crop ↓ Create Crop Record ↓ Generate Digital Passport ↓ Generate QR Code ↓ Scan QR Code ↓ Open Public Crop Passport

The QR code can be used to quickly access the corresponding crop's digital information. This can be useful for: Farmers Buyers Agricultural organizations Supply-chain participants Demonstration farms Future certification systems

📷 4. QR Scanner HarvestID includes a QR scanning interface that allows users to scan crop passport QR codes. The scanner can identify the corresponding crop passport and open its digital information. This creates a simple bridge between the physical crop/farm environment and the digital crop record.

🌱 5. Crop Lifecycle Activity Tracking Farmers can record important activities throughout the crop lifecycle. Examples include: 🌱 Sowing 💧 Irrigation 🧪 Fertilization 🐛 Pest Monitoring 🌿 Crop Monitoring 🌾 Harvest 📝 General Field Notes

Each activity can contain: Activity type Date Crop association Notes Photos Audio AI enhancement information AI-generated summaries Confidence information This creates a chronological history of the crop.

📅 6. Crop Activity Timeline Every crop can have a chronological activity timeline.

Example: Day 1 🌱 Sowing ↓ Day 8 💧 Irrigation ↓ Day 15 🧪 Fertilization ↓ Day 22 🐛 Pest Monitoring ↓ Day 45 🌿 Crop Monitoring ↓ Harvest 🌾

This allows farmers to understand the crop's lifecycle at a glance.

🤖 7. AI Farmer Assistant HarvestID includes an AI-powered Farmer Assistant. The assistant is designed to provide agricultural guidance using:

• Farmer's selected language
• Crop context
• Crop information
• Existing crop activities
• Location information

Farmers can ask questions such as:

 "What fertilizer should I use?"

"Why are my tomato leaves turning yellow?"

"When should I irrigate this crop?"

"What pests commonly affect this crop?"

"How can I improve crop health?"

The AI assistant can provide practical agricultural guidance while considering available crop and location context.

🌍 8. Multilingual Farmer Interface

HarvestID is designed for farmers who may not be comfortable using English-only applications.

The platform supports 13 languages.

Supported Languages Code Language

EN English HI Hindi KN Kannada TE Telugu TA Tamil ML Malayalam MR Marathi BN Bengali GU Gujarati PA Punjabi OR Odia AS Assamese UR Urdu

The selected language applies across the application.

This includes:

Dashboard Navigation Crop registration Crop details Activities Passport Settings AI Assistant Empty states Loading states Error messages Voice navigation

The language preference is persisted so it remains selected after refreshing or navigating between pages.

🗣️ 9. Voice Interaction

HarvestID is designed to support voice-based interaction for farmers. Farmers can interact with the application using voice input.

The system supports:

Voice questions Voice navigation commands Multilingual speech recognition AI-generated voice responses Selected-language speech output

• Voice workflow

Farmer speaks ↓ Speech recognition ↓ Selected language detected/used ↓ Question sent to AI ↓ AI generates response ↓ Response displayed as text ↓ Response spoken through voice

This reduces dependence on typing and improves accessibility for users who prefer speaking.

📍 10. GPS & Location Awareness

HarvestID can capture the crop's location using the device GPS.

The system uses:

GPS Location ↓ Latitude / Longitude ↓ Reverse Geocoding ↓ Readable Location ↓ Stored with Crop

The location can then be used as part of the crop record and passed into the AI assistant context. This allows the AI assistant to provide more location-aware agricultural guidance.

🧠 11. Location-Aware AI

The Farmer Assistant can consider available location context when answering agricultural questions.

For example, agricultural advice can take into account:

Crop Farm location Crop activities Existing crop information Farmer's selected language

This creates a more contextual farming assistant instead of a completely generic chatbot.

🖼️ 12. Dynamic Crop Image System

HarvestID includes a centralized crop-image resolution system.

Instead of displaying a small fixed set of images, crop names are dynamically mapped to appropriate crop images.

The system supports:

Crops Fruits Vegetables Grains Pulses Commercial crops Regional crop names Singular/plural names Common aliases

Examples: Tomato Tomatoes Cherry Tomato Desi Tomato

can resolve to the appropriate tomato image. Similarly: Brinjal Eggplant Baingan Aubergine

can resolve to the same crop identity. The system also supports many Indian/regional crop names.

📸 13. Farmer Crop Image Upload

Farmers can upload their own crop images during crop registration. The uploaded image takes priority over the default crop catalog image.

Priority Farmer Uploaded Image ↓ YES ↓ Display Upload ↓ NO ↓ Crop Image Catalog ↓ Found? /
YES NO ↓ ↓ Crop Image Honest Placeholder

This prevents the application from showing an incorrect crop image for an unknown crop.

🎨 14. Premium Agricultural UI

HarvestID uses a modern agriculture-inspired interface.

The UI includes: Agricultural visual identity Responsive layouts Animated elements Floating agricultural elements Interactive cards Animated assistant interface Modern navigation Light and dark theme compatibility Mobile-friendly layouts Smooth transitions Reduced-motion accessibility support

The visual design is intended to feel like a modern agricultural technology platform rather than a traditional farm management application.

🌓 15. Responsive Design

HarvestID is designed for: 📱 Mobile phones 📱 Tablets 💻 Laptops 🖥️ Desktop systems The interface adapts navigation, branding, cards, dashboards and controls according to screen size.

🏷️ 16. HarvestID Branding

HarvestID uses a centralized official logo system. The logo is implemented through a reusable component so that branding remains consistent across: Sidebar Dashboard Mobile header Desktop header Passport Farmer Assistant Footer Empty states Browser favicon This avoids maintaining multiple independent versions of the logo.

🏗️ System Architecture

                             ┌──────────────────────┐
                             │      FARMER          │
                             └──────────┬───────────┘
                                        │
                                        ▼
                             ┌──────────────────────┐
                             │   HarvestID Frontend │
                             │   Web Application    │
                             └──────────┬───────────┘
                                        │
                  ┌─────────────────────┼──────────────────────┐
                  │                     │                      │
                  ▼                     ▼                      ▼
             Crop System          AI Assistant          QR Passport
                  │                     │                      │
                  ▼                     ▼                      ▼
              Activities          Gemini AI              Public URL
                  │                     │                      │
                  └─────────────────────┼──────────────────────┘
                                        │
                                        ▼
                             ┌──────────────────────┐
                             │     Express API      │
                             │   Node.js Backend    │
                             └──────────┬───────────┘
                                        │
                                        ▼
                             ┌──────────────────────┐
                             │      Supabase        │
                             │ Database + Storage   │
                             └──────────────────────┘

🔄 Crop Passport Workflow

            Farmer
              │
              ▼
            Register Crop
              │
              ├── Crop Information
              ├── Variety
              ├── Farm
              ├── Area
              ├── GPS
              ├── Image
              └── Notes
              │
              ▼
            Crop Stored in Database
              │
              ▼
            Record Field Activities
              │
              ├── Sowing
              ├── Irrigation
              ├── Fertilization
              ├── Pest Monitoring
              └── Harvest
              │
              ▼
            Generate Crop Passport
              │
              ▼
            Generate QR Code
              │
              ▼
            Share / Scan
              │
              ▼
            Public Digital Crop Passport

🤖 AI Assistant Workflow

                      Farmer
                         │
                         ▼
                      Text / Voice Question
                         │
                         ▼
                      Language Selection
                         │
                         ▼
                      Crop Context
                         │
                         ├── Crop Name
                         ├── Activities
                         ├── Location
                         └── Other Available Data
                         │
                         ▼
                      HarvestID Backend
                         │
                         ▼
                      Google Gemini
                         │
                         ▼
                      AI Response
                         │
                         ├── Text Response
                         └── Voice Response
                         │
                         ▼
                      Farmer

🌐 Production Architecture

HarvestID uses a separated frontend/backend architecture.

            GitHub
              │
              ├──────────────► Vercel
              │                  │
              │                  ▼
              │             Frontend
              │
              └──────────────► Render
                                 │
                                 ▼
                             Node.js API
                                 │
                                 ▼
                             Supabase
                                 │
                                 ├── Database
                                 └── Data Services
            
                                 │
                                 ▼
                             Google Gemini
                             AI Services

🛠️ Technology Stack

Frontend: React TypeScript TanStack Start Vite CSS Responsive UI Browser Web APIs

Backend: Node.js Express JavaScript REST APIs CORS Environment configuration

Database: Supabase PostgreSQL Row Level Security

AI: Google Gemini API Gemini Flash models Multilingual AI responses Context-aware agricultural assistance

Deployment: GitHub Vercel — Frontend Render — Backend Supabase — Database

Browser APIs: Geolocation API Web Speech API Camera/QR functionality Local Storage

📁 Project Structure:

        harvest-id-passport/
        │
        ├── backend/
        │   ├── config/
        │   ├── controllers/
        │   ├── middleware/
        │   ├── models/
        │   ├── routes/
        │   ├── services/
        │   ├── utils/
        │   ├── schema.sql
        │   └── server.js
        │
        ├── public/
        │   └── logo/
        │       └── harvestID logo.jpeg
        │
        ├── src/
        │   ├── components/
        │   │   ├── HarvestIDLogo.tsx
        │   │   ├── FarmerAssistant.tsx
        │   │   ├── CropCard.tsx
        │   │   ├── Timeline.tsx
        │   │   └── ...
        │   │
        │   ├── i18n/
        │   │   └── ...
        │   │
        │   ├── lib/
        │   │   ├── harvest-store.tsx
        │   │   ├── crop-images.ts
        │   │   ├── crop-l10n.ts
        │   │   └── ...
        │   │
        │   ├── routes/
        │   │   ├── index.tsx
        │   │   ├── crops.new.tsx
        │   │   ├── crops.$cropId.tsx
        │   │   ├── passport.$cropId.tsx
        │   │   └── ...
        │   │
        │   └── styles.css
        │
        ├── .gitignore
        ├── package.json
        └── README.md

🔐 Security & Environment Variables

Sensitive environment variables are not committed to GitHub.

The project protects environment files through .gitignore.

Important production variables include:

Vercel: VITE_API_BASE_URL VITE_PUBLIC_SITE_URL

Render: SUPABASE_URL SUPABASE_ANON_KEY GOOGLE_API_KEY PORT

API keys remain server-side and are never intentionally exposed to the browser.

🗄️ Database:

Supabase provides the primary backend data layer.

Important data includes:

Harvest Stores crop information. Example fields: id crop name variety category farm name gps area score passport image note

Activities:

Stores crop lifecycle activities. Example fields: id crop_id kind title note date media ai_enhanced ai_summary confidence photo audio created_at

🔒 Row Level Security:

Supabase Row Level Security is enabled for relevant tables.

Policies are configured to allow the backend application to perform the required database operations using the configured Supabase credentials.

🧪 Testing & Validation:

The production application has been validated through: TypeScript compilation Production build Backend syntax validation API endpoint testing Crop CRUD testing Activity CRUD testing Passport persistence testing QR/public passport testing Supabase schema migration testing AI API testing Multilingual AI testing GPS integration validation Crop image resolver testing SSR production rendering Production deployment verification

✅ Production Health:

Current production architecture:

    Component        Platform                  Status
    
    Frontend          Vercel                 🟢 Live
    Backend API       Render                 🟢 Live
    Database          Supabase               🟢 Connected
    AI                Google Gemini          🟢 Connected
    Source Control    GitHub                 🟢 Active
    QR Passport       HarvestID              🟢 Active
    Multilingual UI   13 Languages           🟢 Active
    Voice Interaction Browser Speech APIs    🟢 Active
    GPS               Browser Geolocation    🟢 Active

🌍 Example Use Case:

Scenario

A farmer registers a tomato crop.

    Crop:
    Tomato
    
    Variety:
    Hybrid Tomato
    
    Farm:
    My Farm
    
    Area:
    2 Acres
    
    Location:
    GPS captured automatically

The farmer then records: 🌱 Sowing 💧 Irrigation 🧪 Fertilization 🐛 Pest Monitoring 🌿 Crop Monitoring

The farmer can ask: "Why are the leaves of my tomato plants turning yellow?"

The AI assistant receives relevant crop context and available location information and provides guidance in the farmer's selected language. Later, the farmer generates a digital crop passport. The passport can be accessed using a QR code.

🎯 Target Users:

HarvestID is designed primarily for: 👨‍🌾 Farmers 👩‍🌾 Agricultural workers 🌱 Farmer groups 🏢 Agricultural organizations 🧑‍🔬 Agricultural researchers 🛒 Agricultural buyers 🚜 Agri-tech ecosystems 🌾 Future supply-chain participants

🌟 Why HarvestID? Traditional crop records can be: Paper-based Fragmented Difficult to update Difficult to share Difficult to trace

HarvestID transforms crop records into a structured digital identity.

Traditional

  Paper Records
       ↓
  Scattered Information
       ↓
  Difficult Tracking
       ↓
  Limited Accessibility

HarvestID

Digital Crop Identity
        ↓
Centralized Crop Data
        ↓
Lifecycle Tracking
        ↓
AI Assistance
        ↓
QR Passport
        ↓
Easy Sharing & Access

🏆 Project Vision:

HarvestID aims to become a digital identity layer for agriculture. The long-term vision is: Seed ↓ Sowing ↓ Growth ↓ Irrigation ↓ Fertilization ↓ Crop Monitoring ↓ Harvest ↓ Processing ↓ Distribution ↓ Consumer with digital information connected throughout the crop lifecycle.

👨‍💻 Development Philosophy:

HarvestID follows a modular architecture where major capabilities are separated into reusable components and services.

Core principles: Modular development Reusable components Centralized state management API-driven architecture Secure environment handling Responsive design Accessibility Multilingual support Production validation Scalable architecture

🔗 Links 🌐 Live Application: https://harvest-id-passport.vercel.app⁠�

💻 GitHub Repository: https://github.com/03darshanpatil-code/harvest-id-passport⁠�

⚙️ Backend API: https://harvest-id-backend.onrender.com⁠�

🌱 HarvestID Give Every Crop a Digital Identity. From Seed to Harvest — Trace Every Step.