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.

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.