1Getting Started
GoviHub Spices connects Sri Lankan spice farmers directly to verified commercial buyers. This guide walks you through every feature available to you as a farmer.
1.1 What You Need
- ●A smartphone with internet access (Android or iPhone)
- ●Chrome, Safari, or any modern web browser
- ●Photos of your crops (for disease diagnosis)
1.2 Creating Your Account
Go to spices.govihublk.com in your browser
On the landing page, tap the "Register" button
Username, password, full name, phone number, and district
Choose "Farmer" as your role
Pick the spices you grow: pepper, turmeric, ginger, cloves, nutmeg, cardamom, or cinnamon
Allow GPS access or enter your district manually. This is used for weather forecasts and buyer matching
You will be taken to your Farmer Dashboard
2Your Dashboard
The dashboard is your home screen. It shows everything important at a glance:
- ●Weather summary for your location (today’s temperature, rain forecast)
- ●Your active harvest listings and their status
- ●Recent matches with buyers
- ●Notification badge showing unread alerts
3Creating Harvest Listings
A harvest listing tells buyers what you have available to sell. This is the core of how you connect with buyers on GoviHub.
3.1 How to Create a Listing
Tap "Listings" from the bottom navigation bar or the More menu
The create listing form will open
Choose from: black pepper, turmeric, ginger, cloves, nutmeg, cardamom, cinnamon, or mixed spices
How many kilograms you have available
Price per kilogram in Sri Lankan Rupees (LKR)
Select the grade of your harvest (Grade A, B, or C)
When the harvest will be ready for collection
Take a photo of your harvest. Buyers prefer listings with photos
Any extra details: organic, dried/fresh, processing method, etc.
Your listing goes live and the matching engine starts looking for buyers
3.2 Managing Your Listings
After creating a listing, you can:
- ●Edit \u2014 Update quantity, price, or description at any time
- ●Change Status \u2014 Mark as sold, expired, or reactivate
- ●Delete \u2014 Remove a listing you no longer need
4Smart Matching with Buyers
GoviHub's matching engine automatically pairs your harvest listings with buyer demand postings. It scores each potential match based on:
- ●Distance between you and the buyer (35% weight) \u2014 closer buyers are preferred
- ●Quantity fit (25%) \u2014 does your harvest size match what they need?
- ●Date overlap (25%) \u2014 is your harvest ready when they need it?
- ●Listing freshness (15%) \u2014 newer listings get a boost
4.1 Working with Matches
When a match is found, you'll see it on your Matches page and receive a notification. For each match, you can:
See the buyer’s name, location, requested quantity, and price range
You agree to supply this buyer. The match moves to "accepted" status
Not interested. The match is removed
Ignore for now without rejecting
After delivering the goods, mark the match as completed
5AI Crop Disease Diagnosis
If your spice crop looks unhealthy, GoviHub's AI can help identify the problem and suggest treatments.
5.1 How to Use Diagnosis
Tap "Diagnosis" from the navigation menu
Take a clear, close-up photo of the affected leaf or plant part. Good lighting is essential
The AI (Claude Sonnet 4) analyzes your image. This takes 5–15 seconds
You’ll see: the identified disease name (in English and Sinhala), treatment recommendations, and prevention advice
Give feedback on whether the diagnosis was helpful — this improves the system
5.2 Diagnosis History
All your past diagnoses are saved. Go to Diagnosis > History to review previous results and track how treatments are working.
6AI Farm Advisory
The Farm Advisory is your personal agricultural consultant. Ask any farming question in Sinhala or English and get expert answers powered by Sri Lankan Department of Agriculture knowledge.
6.1 How It Works
The advisory uses a knowledge base of 595 articles covering all 8 spice crops, sourced from Sri Lankan agricultural publications. When you ask a question:
- ●Your question is matched against the knowledge base using AI
- ●The most relevant articles are retrieved
- ●Claude AI generates a detailed answer grounded in those articles, in Sinhala
6.2 Example Questions
- ●ග්රීෂ්ම කාලයට ගම්මිරිස් වෙල හානි වෙනවා? (What pests harm black pepper in summer?)
- ●How do I dry turmeric for best color retention?
- ●ඉඟුරු වෙලට හාරි පහසු කිරීමට මෙන්? (What is good fertilizer for ginger?)
7Weather Forecasts & Alerts
GoviHub provides 5-day weather forecasts tailored to your farm location, with specific advice for your spice crops.
7.1 Weather Dashboard Card
Your dashboard shows today's weather summary: temperature, humidity, wind speed, and rain probability. The first 3 days are marked as "reliable" and the remaining days as "outlook."
7.2 Detailed Forecast
Tap the weather card or go to Weather from the menu to see:
- ●5-day forecast with daily high/low temperatures
- ●Hourly detail for any day (tap a day to expand)
- ●Soil temperature and moisture data (critical for turmeric, ginger)
- ●Humidity and wind speed charts
7.3 Weather Alerts
GoviHub monitors weather conditions against your crop profiles and sends automatic alerts when:
- ●Heavy rain threatens drainage (especially for pepper, ginger)
- ●Temperature drops below critical thresholds for your crops
- ●High winds could damage vine crops like pepper
- ●Soil moisture conditions require attention
Each alert comes in Sinhala with a specific action you should take (e.g., "Clear drainage channels").
8Supply Marketplace
Browse and inquire about farming inputs \u2014 seeds, fertilizers, tools, and equipment \u2014 listed by verified suppliers.
Tap "Marketplace" from the navigation
Filter by category (seeds, fertilizer, tools) or search by keyword
Tap any listing to see price, availability, supplier info, and photos
Tap the inquiry button to reach the supplier about a product
9Notifications
GoviHub sends you notifications for:
- ●New buyer matches for your harvest listings
- ●Match status updates (accepted, completed, etc.)
- ●Weather alerts for your crops
- ●Platform announcements from GoviHub admins
The notification bell on your dashboard shows the count of unread notifications. Tap it to see all notifications, and mark them as read individually or all at once.
10Settings & Profile
10.1 Profile Settings
Update your personal information: full name, phone number, district and location, land size, and farming experience.
10.2 Crop Selection
Go to Settings > My Crops to add or remove spice crops from your profile. This affects which weather alerts you receive and which buyers are matched to you.
10.3 Notification Preferences
Control which notifications you receive. You can enable or disable alerts for matches, weather, prices, and announcements.
10.4 Change Password
Go to Settings > Change Password. You'll need your current password to set a new one.
11Giving Feedback
Help us improve GoviHub! Go to the More menu and tap "Feedback" to share your thoughts, report bugs, or suggest new features. Every piece of feedback is read by the GoviHub team.
12Quick Reference
| I want to… | Go to… |
|---|---|
| Sell my harvest | Listings > Create New |
| See buyer matches | Matches (bottom nav) |
| Check weather | Dashboard weather card or Weather page |
| Diagnose a sick crop | Diagnosis > Upload Photo |
| Ask a farming question | Advisory |
| Buy seeds/fertilizer | Marketplace |
| See my notifications | Notification bell on dashboard |
| Update my crops | Settings > My Crops |
| Change my password | Settings > Change Password |
| Give feedback | More > Feedback |
Need Help?
- ●Use the AI Farm Advisory to ask any farming question
- ●Submit feedback through the app (More > Feedback)
- ●Contact your local GoviHub field coordinator