AgricVue Complete User Guide

All app features, step by step

This guide explains what each feature does, exactly how to use it, and the practical benefit to farmers.

Create account

Quick Start In 6 Steps

1

Create account and sign in

2

Choose your plan

3

Register farm boundary

4

Run analysis

5

Enable monitoring

6

Generate report

Feature Documentation

All users

Account Registration, Login, and Join Link

What it does: Creates accounts, signs users in, and allows farmers to join a cooperative invitation.

Where: /register, /login, /join/{inviteCode}

How to use it

  1. Open Register and submit name, email, phone, and password.
  2. If invited by a cooperative, use /join/{inviteCode} and complete the join form.
  3. Login and continue to dashboard.

Farmer benefit: Fast onboarding gets farmers into analysis and monitoring quickly.

Account owner

Plan Selection, Checkout, and Billing

What it does: Compares plans, processes payments, and tracks usage and billing history.

Where: /onboarding/select-plan, /dashboard/billing/*

How to use it

  1. Open Compare Plans and choose monthly or annual billing.
  2. Proceed to checkout and pay with Stripe or Paystack.
  3. Verify subscription and usage limits on Billing dashboard.

Farmer benefit: Farmers can match platform spend to farm scale and avoid unnecessary costs.

All users

Main Dashboard

What it does: Shows farm totals, area, analysis completion, and quick actions.

Where: /dashboard

How to use it

  1. Open Dashboard after login.
  2. Review total farms, total area, analyses, and reports.
  3. Use Quick Actions to register farm, run analysis, or view reports.

Farmer benefit: Provides a daily control center for faster farm decisions.

All users

Farm Registration and Farm Workspace

What it does: Stores farm records, captures boundaries by map or coordinates, and centralizes farm tools.

Where: /dashboard/farms, /dashboard/farms/new, /dashboard/farms/{farmId}

How to use it

  1. Open My Farms and click Add Farm.
  2. Draw at least 3 map points or add coordinates manually.
  3. Open farm details to access map, stats, and tool cards.

Farmer benefit: Accurate boundaries improve data quality and reduce field guesswork.

All users

Run Analysis (Quick and Custom)

What it does: Runs crop suitability and risk analysis with quick mode or modular feature selection.

Where: /dashboard/farms/{farmId}, /dashboard/analyses/{analysisId}

How to use it

  1. In Farm Details, open Run Analysis.
  2. Choose quick analysis type or custom feature mode.
  3. Start analysis and monitor task progress from Analyses page.

Farmer benefit: Helps farmers identify best zones for planting and risk mitigation before spending inputs.

All users

Monitoring Setup, Heatmaps, and AI Advice

What it does: Configures schedule, indices, thresholds, alerts, and shows index heatmaps with AI recommendations.

Where: /dashboard/monitoring, /dashboard/farms/{farmId}/monitoring

How to use it

  1. Open farm monitoring and click Setup Monitoring.
  2. Set frequency, indices, thresholds, and notification preferences.
  3. Review latest maps, AI recommendations, and use Run Now when needed.

Farmer benefit: Enables early intervention in stressed zones to protect yield.

All users

Historical Trends and Lab-Backed Interpretation

What it does: Analyzes recent or custom date-range trends across vegetation, moisture, chlorophyll, pH, and stress.

Where: /dashboard/farms/{farmId}/monitoring/historical

How to use it

  1. Open Historical Trends and choose a category.
  2. Select Recent mode or Custom Date Range mode.
  3. Add farm events or lab data to improve interpretation.

Farmer benefit: Shows long-term crop direction, not just single-date health snapshots.

All users

Weather Advisory

What it does: Generates AI weather guidance with 3-day forecast, risk flags, and practical recommendations.

Where: /dashboard/farms/{farmId}/weather-advisory

How to use it

  1. Open Weather Advisory from Farm Tools.
  2. Review severity, forecast strip, and recommendation list.
  3. Generate a fresh advisory if conditions change.

Farmer benefit: Improves timing for irrigation, spraying, and field movement.

All users and lenders

Land Assessment and Credit Score

What it does: Evaluates pre-planting land suitability over a selected period and computes finance-ready farm credit score.

Where: /dashboard/farms/{farmId}/land-assessment, /dashboard/farms/{farmId}/credit-score

How to use it

  1. Run Land Assessment by selecting date range and starting processing.
  2. Review baseline outputs and compare with past assessments.
  3. Open Credit Score and recompute after fresh monitoring or lab updates.

Farmer benefit: Improves crop planning quality and strengthens financing readiness.

All users

Reports and Export

What it does: Generates detailed farm reports and exports them to PDF or DOCX.

Where: /dashboard/reports, /dashboard/reports/{id}, /dashboard/reports/{id}/generate

How to use it

  1. Generate report from analysis or reports page.
  2. Review executive summary and recommendation sections.
  3. Export and share with extension staff, buyers, or lenders.

Farmer benefit: Creates clear, shareable evidence for farm decisions and support requests.

All users (API for advanced users)

Settings, API Keys, and Offline Status

What it does: Updates profile/password, manages secure API keys, and indicates online/offline state in dashboard.

Where: /dashboard/settings, /dashboard/settings/api-keys

How to use it

  1. Open Settings to update profile and change password.
  2. Create scoped API keys if integration is needed.
  3. Watch offline banner and refresh pages after reconnecting.

Farmer benefit: Protects account access while keeping workflows reliable in weak connectivity.

Tenant admin

Team Management (Cooperative Admin)

What it does: Creates and manages farmers, supports batch actions, password reset, and farm assignment.

Where: /dashboard/team, /dashboard/team/{farmerId}

How to use it

  1. Open Team to add or search farmers.
  2. Use batch activate, deactivate, delete, or export actions.
  3. Open Farmer Details to assign farms and manage account status.

Farmer benefit: Lets cooperatives support more farmers with consistent account control.

Tenant admin

Cooperative Operations

What it does: Provides KPI dashboard, invitation links, CSV onboarding, analytics, and full audit log.

Where: /dashboard/cooperative, /dashboard/cooperative/invitations, /dashboard/cooperative/bulk-upload, /dashboard/cooperative/analytics, /dashboard/cooperative/activity

How to use it

  1. Use Cooperative dashboard checklist to complete setup.
  2. Invite farmers by link/email or bulk upload by CSV template.
  3. Track growth and health in Analytics, then verify events in Activity Log.

Farmer benefit: Scales cooperative delivery while maintaining transparency and data quality.

All users

Disease Detection and Treatment

What it does: Identifies crop diseases from photos using AI, provides treatment plans with product names, dosage, cost, and spread prediction.

Where: /dashboard/farms/{farmId}/disease, Scan tab (mobile)

How to use it

  1. Open the Scan tab on mobile or Farm > Disease on web.
  2. Photograph the affected leaf, stem, or fruit clearly with good lighting.
  3. Review: disease name, confidence score, severity, and treatment recommendations.

Farmer benefit: Early detection reduces crop loss and treatment costs significantly.

All users

Yield Prediction and Growth Tracking

What it does: Predicts harvest yield from peak-NDVI regression and tracks crop growth stages from emergence to maturity.

Where: /dashboard/farms/{farmId} (Yield Prediction, Growth Trajectory)

How to use it

  1. Open Farm details and view Yield Prediction for projected kg/ha and revenue.
  2. Check Growth Trajectory for current stage, velocity, and days-to-maturity.
  3. Monitor for growth-stall or senescence alerts as harvest approaches.

Farmer benefit: Farmers can plan harvest logistics and sales before the crop is ready.

All users

Insurance Enrollment

What it does: Enroll in parametric insurance (auto-payout when satellite triggers are breached) or MPCI (custom multi-peril coverage).

Where: /dashboard/farms/{farmId}/insurance

How to use it

  1. Open Farm > Insurance and browse available policies.
  2. For parametric: review trigger conditions, premium, and click Enroll.
  3. For MPCI: select perils (drought, flood, pest, etc.), get a quote, confirm.

Farmer benefit: Satellite-verified payouts eliminate claims paperwork and adjuster delays.

All users and lenders

Credit Score

What it does: Generates a 0-100 agricultural credit score from 7 factors: vegetation health, yield potential, management, soil, climate risk, farm profile, and data quality.

Where: /dashboard/farms/{farmId}/credit-score

How to use it

  1. Open Farm > Credit Score to view your composite score and factor breakdown.
  2. Improve by monitoring consistently, logging events, and entering lab tests.
  3. Share with lenders through the Partnerships feature for loan applications.

Farmer benefit: Translates farming performance into a credit profile lenders understand.

All users

Flood Monitoring

What it does: Sentinel-1 radar detects water on your farm through clouds. Tracks flood events, crop damage, recovery, and drainage recommendations.

Where: /dashboard/farms/{farmId} (Flood Events)

How to use it

  1. Open Farm > Flood Events to view the flood timeline and severity.
  2. Review crop damage estimate and expected recovery days.
  3. Use AI drainage recommendations with 3D terrain viewer for remediation.

Farmer benefit: Satellite-confirmed flood data serves as evidence for insurance claims.

All users

Farm Events and Lab Tests

What it does: Log planting, fertilizing, spraying, harvesting, and lab test results. All entries improve AI recommendations and credit score.

Where: /dashboard/farms/{farmId} (Events, Lab Tests)

How to use it

  1. Go to Farm > Events > Log Event and select the event type.
  2. Enter date, product details, and optional notes or photos.
  3. For lab tests: enter N, P, K, pH, micronutrients with lab name and sample ID.

Farmer benefit: Every logged event improves your Farm Management credit score factor (15% weight).

All users

Partnerships and Data Sharing

What it does: Consent-based data sharing with lenders, insurers, and buyers. Generate codes, approve requests, revoke access anytime.

Where: /dashboard/farms/{farmId}/partnerships

How to use it

  1. Go to Farm > Partnerships and click Generate Code.
  2. Share the code with your lender or insurer.
  3. Review incoming requests and Approve or Reject. Revoke access at any time.

Farmer benefit: Opens access to finance and insurance while keeping farmers in control of their data.

All users

Harvest Certificates

What it does: Digital certificates with satellite-verified area, health grade, predicted yield, and public verification URL.

Where: /dashboard/farms/{farmId}/certificates

How to use it

  1. Go to Farm > Certificates and click Request Certificate.
  2. Download the PDF with unique certificate number and QR code.
  3. Share the public verification URL with buyers or lenders. No login required.

Farmer benefit: Verifiable proof of farming activity builds trust with buyers and unlocks premium pricing.

All users

Mobile App and Offline Mode

What it does: Field-optimized app with GPS boundary survey, camera disease scanning, offline data entry, push notifications, and text-to-speech.

Where: Google Play Store / Apple App Store

How to use it

  1. Download the app and log in. Navigate via 5 tabs: Home, Farms, Scan, Alerts, Profile.
  2. Use GPS Survey to walk your farm perimeter for the most accurate boundary.
  3. Work offline: surveys, scans, events, and lab entries queue and sync automatically.

Farmer benefit: Full functionality even in rural areas with intermittent connectivity.

All users

WhatsApp Bot

What it does: Access weather, farm health, and advisories through WhatsApp. Supports English, Hausa, Yoruba, Igbo, and French.

Where: WhatsApp (send any message to start)

How to use it

  1. Send any message to the AgricVue WhatsApp number.
  2. Send 'weather' or '1' for daily advisory. 'farm' or '2' for health status.
  3. Send 'stop' to pause alerts. Send 'start' to resume.

Farmer benefit: Farmers who prefer WhatsApp get key intelligence without opening an app.

All users

12-Language Support and Text-to-Speech

What it does: Full interface in 12 languages including Nigerian Pidgin, Hausa, Yoruba, and Igbo. Text-to-speech reads advisories aloud.

Where: Profile > Settings (mobile app)

How to use it

  1. Open Profile > Settings and select your preferred language.
  2. Enable Text-to-Speech to hear advisory content read aloud.
  3. Tap the speaker icon on any advisory or recommendation screen.

Farmer benefit: Makes satellite intelligence accessible to non-literate farmers in their own language.

FAQ

When should I run a new analysis?

Before each new season, after major weather changes, or when switching crop plans.

When should I use Run Now in monitoring?

After heavy rain, heat spikes, pest suspicion, or before expensive input application.

How do I improve farm credit score?

Keep monitoring active, log events, update lab tests, and reduce stress zones shown in maps.

How does disease detection work?

Take a photo of the affected crop on your phone. The AI identifies the disease, severity, and gives treatment recommendations with product names and dosage.

Does the app work without internet?

Yes. GPS surveys, disease scans, event logging, and lab entries work offline. Data syncs automatically when connectivity returns.

How does parametric insurance pay out?

When satellite or weather data crosses the trigger threshold (e.g., rainfall drops below 60% of normal), a claim is automatically filed with satellite evidence. No paperwork or adjuster visit needed.

Can I use the platform without a smartphone?

Yes. The WhatsApp bot lets you check weather, farm health, and advisories from any phone with WhatsApp. You can also use the full web dashboard on a computer.

How do I share data with a lender or insurer?

Go to Farm > Partnerships > Generate Code. Share the code with the partner. They request access, and you approve or reject. You can revoke access at any time.

What languages are supported?

The mobile app supports 12 languages: English, Nigerian Pidgin, Hausa, Yoruba, Igbo, French, Spanish, Portuguese, Arabic, Swahili, Hindi, and Chinese. The WhatsApp bot supports English, Hausa, Yoruba, Igbo, and French.

In-Depth Training

Want detailed training material?

Our comprehensive Training Guide provides step-by-step modules for farmers, agronomists, and cooperative leaders — including vegetation index interpretation, best practices by role, and a full glossary of terms.

Open Training Guide