Harvest Workflow

This guide covers how to find blocks that are ready to harvest, record each flush, apply quality grades, and track cumulative yield over time.

Prerequisites

• Blocks that have reached the Fruiting or Harvesting stage. Harvest recording is only available on blocks in one of these two stages.
• The Worker, Manager, or Owner role is required to record harvests.

Step 1: Identify Ready Blocks

Anyone signed in, including Viewers, can find harvestable blocks in these ways.

From the Dashboard:

1. Open Dashboard. In your phone’s browser, tap the Sporeline logo in the top bar to return here from another page. If you are signed out, the logo opens sign-in instead.
2. Tap Fruiting to open Blocks with the Stage filter set to Fruiting.
3. Harvestable counts blocks in both Fruiting and Harvesting. When all are in one stage, tap it to open that stage’s list. When there are none, it opens Fruiting. When blocks are in both stages, the card shows the total without a link; use Blocks and check each stage separately.

From the Blocks list:

1. Navigate to Blocks in the sidebar.
2. Use the Stage filter and select Fruiting or Harvesting.
3. The list will show only blocks at those stages. Click any block to open its detail page.

By scanning a label:

1. Navigate to Scan in the sidebar.
2. Scan the QR code on the block label. You will land directly on the block detail page.

The top of the block detail page shows your farm’s stages in order, with the block’s current stage marked.

Step 2: Move the Block to Harvesting (if your farm uses it)

Skip this step if your farm has no Harvesting stage. If it does, and the block is at Fruiting and you are ready to start cutting:

1. In the Move card at the top of the block detail page, click Harvesting.
2. Click Move.

You can also record harvests while the block is still at Fruiting — for example, if you harvest a first flush before moving it forward. Both stages allow harvest recording.

Step 3: Record a Flush

1. On the block detail page, go to the Move card at the top. If the block has no later stage to move to, the card is titled Harvest instead.
2. Click Record Harvest, below the stage buttons. A form opens.
3. Fill in the form:
   • Weight — the fresh weight of mushrooms harvested in this flush. Enter it in your farm’s weight unit (grams, pounds or ounces), which the field label shows. Sporeline stores all weights internally in grams.
   • Flush Number — defaults to your next flush number based on the block’s history. Edit this if the block was harvested outside the app previously.
   • Grade — select a quality grade from your configured grading scheme (for example, A, B, or C), or type one in if no scheme is configured.
   • Notes — optional notes about this flush (color, contamination spots, unusual growth, etc.).
4. Click Save Harvest.

The harvest is saved and the Harvest History table on the block detail page is updated. The Total Yield KPI also increases.

Step 4: Review Harvest History

The Harvest History table on the block detail page shows every flush recorded for this block:

Use this table to confirm entries and audit flush-by-flush performance.

Step 5: Record Additional Flushes

Repeat Step 3 for each subsequent flush. Sporeline automatically increments the suggested flush number each time. There is no limit on the number of flushes per block.

Step 6: Move the Block On

After the last flush, move the block to its next stage. Which stages are offered depends on how your farm set up its stages. For example:

• Resting, if your farm uses it, for a rest between cycles. The block can go back to Fruiting afterwards.
• Completed, when the block is finished. This ends the block.

1. In the Move card at the top of the block detail page, click the stage.
2. Click Move. Completed asks you to confirm.

Quality Grades

Grading schemes are configured per farm under Settings, in the Grading Scheme card (see Configuration Tabs). You can define any set of grade labels (for example, A/B/C, Premium/Standard, or 1/2/Cull). The grade you assign to each flush flows through to the Revenue by Customer and Yield by Recipe reports.

If no grading scheme is configured, the grade field accepts free text.

Yield Reports

All harvest data flows automatically into the reports section:

• Yield by Batch — total yield across all blocks in a batch, broken down by flush
• Yield by Recipe — average and total yield grouped by recipe, useful for comparing substrate formulas
• Contamination — tracks blocks that did not reach harvest (CONTAMINATED or DISCARDED stage)

Navigate to Reports in the sidebar to view these.

The Harvests page lists every finished block. You can filter it by recipe, species, outcome and a from/to date range, and the two date boxes fit side by side on a phone or a narrow window.

What’s Next

• Create a delivery from your harvests — navigate to Deliveries > New Delivery and add line items.
• View yield trends over time on the Reports pages.

With an AI assistant

An AI assistant connected to your farm can record a harvest with harvest_record, through the same harvest save the Record Harvest form uses, so the weight, the flush, the grade check and the block’s totals all work the same way.

It shows you the harvest first. The preview names the block and its stage, the flush number the harvest will take, the weight, whether the grade is one your farm uses, and whether the block moves on to Harvesting (only on farms that use the Harvesting stage). Nothing is recorded by the preview. When you say it’s right, the assistant records it with the one-time code the preview returned. A flush that’s already recorded, a grade your farm doesn’t use, or a block that isn’t fruiting is refused at the preview, so you find out before anything is saved. Farmhand, inside Sporeline, keeps its own confirm card and doesn’t need the code.