FruitLive User Guide

First Login

FruitLive uses email and password sign-in backed by Supabase. Your administrator creates your account and assigns a role before you can access farm data.

1. Open the FruitLive URL provided by your administrator.
2. Enter your email address and password.
3. Click Sign In to enter the portal.
4. If prompted, complete any first-time password change your organisation requires.

Navigating FruitLive

FruitLive uses a left sidebar for day-to-day farm operations. Settings and admin tools live in the gear menu at the bottom of the sidebar.

1. Use the sidebar to open Dashboard, Workers, Schedule, Compliance, Chemicals, Crops, Sites, Assets, Post-Harvest, Water, Finances, and Field clock.
2. Your current module is highlighted in the sidebar.
3. Open the settings gear for My account, Users, Roles, permissions, WhatsApp manager, and other admin tools.
4. The user pill shows your name and role; use it to sign out.
5. Click the ? help icon beside a page title to open this guide at the relevant topic.
6. On smaller screens, collapse the sidebar with the toggle control at the top of the nav.

Understanding Your Role

What you can see and change depends on the role assigned to your account. FruitLive checks permissions on every action.

Dashboard Overview

The dashboard is your landing page — a quick read on the day before you dive into a module. It greets you by name and surfaces live-ops style tiles.

1. Open Dashboard from the sidebar (or click the FruitLive brand at the top).
2. Review the live ops strip for on-the-clock workers, active sites, pay-period accrual, and field-clock sync health.
3. Use the deeper panels below for shortcuts into labour, compliance, crops, and assets when wired to live data.
4. Check the eyebrow date line for context on which day you are viewing.

Workers List

The Workers page is your roster — everyone on the farm, filterable by site, status, and role. Switch between list view and the information sheet for bulk editing.

1. Click Workers in the sidebar.
2. Use the site filter and search to find workers.
3. Toggle List vs Information sheet for day-to-day allocations vs editable worker details.
4. On the information sheet, drag a column heading sideways to put the columns in the order you want, and use Order rows to list workers alphabetically.
5. Click Add worker to create a new profile.
6. Click Export Excel to download the current filtered list.
7. Open a worker row to view their full profile.

Today's Schedule

The Schedule page focuses on who is on the floor today — allocations, attendance, and morning-board style visibility.

1. Click Schedule in the sidebar.
2. Review today's allocations by site and task.
3. Use the search box at the top of the workers column to find someone by name or nickname without scrolling. Press Esc to clear it.
4. Watch the sidebar warning indicator if daily overtime thresholds are exceeded.
5. Use filters to focus on a single site or crew.
6. Record attendance or adjust allocations as your permissions allow.

Weekly Schedule

Plan the week ahead with the calendar-style schedule view. Assign workers to sites and tasks across multiple days.

1. From Workers, open the weekly schedule view or navigate via labour schedule routes.
2. Select the week and site you are planning.
3. Drag or assign workers to days and tasks.
4. Use Assign / schedule actions to add or change allocations.
5. Save changes so field teams and the field clock see the plan.

Worker Profile

A worker profile consolidates personal details, pay rates, documents, training, compliance, equipment, and schedule history.

1. Open a worker from the Workers list.
2. Review tabs for personal info, pay, documents, training, compliance, and equipment.
3. Upload or renew certificates and signed documents as required.
4. Adjust home vs current site when workers move between partner sites.
5. Send WhatsApp invites where your farm uses worker messaging.

Labour Allocation (Legacy)

The legacy allocation board provides a detailed grid for daily crew assignment, compliance exports, and audit-pack generation.

1. Open the labour allocation view when you need the full allocation grid.
2. Expand Compliance & audits to export audit packs or log incidents.
3. Choose a date range for Excel audit exports covering workers, allocations, attendance, and training.
4. Use shared-worker alerts when crews transfer between sites.

Field Clock

Field clock is the mobile-friendly capture surface for indunas and supervisors — QR scan clock-in/out, mileage, and equipment custody in the field.

1. Open Field clock from the sidebar (or install the PWA on a device).
2. Use Camera scan to read worker QR codes for clock in or out.
3. Review Today's labour captures for pending or failed syncs.
4. Log vehicle mileage and confirm equipment used today.
5. Open Today's plan to see scheduled tasks for the site.
6. Resolve queued sync items when connectivity returns.

Compliance & Audits

Track audit readiness across documents, training, certifications, and the audit-year journey. Scores here are operational aids — always confirm against your certification body checklist.

1. Open Compliance & Audits from the sidebar.
2. Filter by site to focus on one farm.
3. Review the audit year journey timeline for scheduled visits.
4. Check audit readiness scores and open gaps.
5. Click Schedule audit to plan a visit.
6. Add certificates and documents as evidence.
7. Export packs from Labour when auditors need worker and attendance evidence.

Chemicals

Manage chemical storage inventory and spray application records. FruitLive helps you keep evidence for audits; it does not replace your IFA or agronomist instructions.

1. Open Chemicals from the sidebar.
2. Filter by site if needed.
3. On the Storage tab, review products, quantities, expiry, and PHI days.
4. Click Add chemical to register a new product in store.
5. Switch to Usage to log spray applications.
6. Click Record spray after a field application.

Crop Monitoring

Track block-level growth, quality measurements, and yield projections across varieties and seasons.

1. Open Crop Monitoring from the sidebar.
2. Filter by site, block, and variety.
3. Review key metrics: days from full bloom, fruit size, and yield indicators.
4. Click Record sampling to log a new measurement.
5. Use Export data when sharing projections with packhouse or marketing.

Sites

Sites are farms, blocks, and fields in your operation. Configure tasks, field maps, and site-level settings here.

1. Open Sites from the sidebar.
2. Browse the site list and open a site to configure it.
3. Add or edit fields/blocks and draw outlines on the map where supported.
4. Manage tasks available for labour allocation at each site.
5. Keep site names aligned with how crews refer to locations in the field.

Asset Management

Track vehicles, equipment, fuel, mileage, maintenance, and custody incidents across the farm.

1. Open Asset Management from the sidebar.
2. Review KPI tiles for fleet health, fuel spend, and pending liability reviews.
3. Add or edit vehicles and equipment in the inventory.
4. Log fuel transactions and daily mileage.
5. Record maintenance when services are completed.
6. Review custody & incidents when equipment damage or loss is reported.

Post-Harvest

Monitor packhouse throughput, consignments, and estimated returns after harvest.

1. Open Post-Harvest from the sidebar.
2. Review summary tiles for volumes, consignments, and returns.
3. Add or edit consignments as fruit moves through the packhouse.
4. Track quality grades and destination markets where configured.

Water & Irrigation

Track abstraction licences, pump meter readings, and irrigation diary entries for audit-ready water evidence.

1. Open Water & Irrigation from the sidebar.
2. Filter by site.
3. Confirm year-to-date volume against your active licence allocation.
4. Register pump meters and log readings on schedule.
5. Record irrigation runs in the diary alongside pump totals.
6. Click Export Excel for auditor-ready workbooks.

Finances

Payroll summaries, site charge sheets, worker pay configuration, and payslip generation for the open pay period.

1. Open Finances from the sidebar.
2. Select the pay period you are reviewing.
3. Review the payroll summary and drill into daily hours per worker.
4. Use the site charge sheet to see labour cost by site.
5. Configure pay rules, job types, and employer settings as needed.
6. Open worker payments for advances and adjustments.
7. Generate payslips when the period is ready to close.

My Account

Update your profile details and password from the settings menu.

1. Open the settings gear at the bottom of the sidebar.
2. Click Manage my account.
3. Update your display name, contact details, or password.
4. Save changes before signing out.

User Management

Create and manage portal user accounts, assign roles, and control active status.

1. Open Settings → Users.
2. Click Add user to invite a new team member.
3. Assign a role that matches their job function.
4. Deactivate users who leave the organisation instead of deleting historical records where policy requires.
5. Search and filter the user list to audit access.

Roles

Define roles and their descriptions. Permissions are configured separately in Role permissions and Role modules.

1. Open Settings → Roles.
2. Create or edit a role name and description.
3. Pair each role with permissions in Role permissions.
4. Control which sidebar modules appear via Role modules.

Role Permissions

The permission matrix controls which database functions each role may execute — the backend enforces these on every request.

1. Open Settings → Role permissions.
2. Select a role to view its function permissions.
3. Toggle EXECUTE (and other operations) for each function.
4. Save changes — users with that role receive updated access on next action.

Role Modules

Control which sidebar modules each role can see, independent of backend permissions.

1. Open Settings → Role modules.
2. Select a role and enable or disable module visibility.
3. Save — the sidebar updates for users on their next navigation.

WhatsApp Manager

Configure WhatsApp messaging for worker invites and site communications where your farm uses the integration.

1. Open Settings → WhatsApp manager.
2. Review channel status and templates.
3. Send test messages before rolling out to field teams.
4. Use the dev console only in non-production troubleshooting.

Common Issues

Solutions to the most frequent FruitLive issues:

Frequently Asked Questions