TurboBatch — Help & User Guide

Welcome to TurboBatch, your mushroom production cockpit. This guide walks through every screen and flow in the app for Managers and Operators on any plan. (Platform-level administration has its own separate manual.)

1. The Basics

1.1 What you can do in TurboBatch

Track every batch from inoculation to harvest
Print Avery 48660 labels for every bag
Build reusable Sprints: weekly batch templates that create a whole run and queue its labels in one click
See real-time production totals, gauges, and trends on the Dashboard
Watch the live Strain Ticker scroll your farm's per-strain stats in real time
Get scheduled email reports (Daily and Weekly) with everything that needs attention
Manage strain timings and target growing conditions
Run multiple farms from one account (on Multi-Farm and above)

1.2 Farms

A farm is a self-contained workspace inside TurboBatch. Each farm has its own batches, strains, locations, branding, and reports. Switch farms using the dropdown in the top navigation.

1.3 Roles — Manager vs Operator

Every team member is assigned a role per farm. The two roles you'll see day-to-day:

Capability	Manager	Operator
Create batches, update status, move locations, log harvest	✅	✅
Print labels	✅	✅
View Dashboard, Calendar, reports	✅	✅
Edit farm settings (name, timezone, units, theme)	✅	—
Edit strain library and target conditions	✅	—
Configure email reports and recipients	✅	—
Invite team members, assign roles	✅	—
Manage Plans & Billing	✅	—

Operators see Settings as read-only or hidden where the action isn't theirs to take. If you hit "Access denied" on something, your Manager can either do it for you or upgrade your role.

1.4 Plans

Your account plan sets how many farms, team members, and active batches you can run, and which email reports are included.

Free — 1 farm, 1 seat (you), 10 active batches (spawn + blocks), 2 locations. Weekly report only.
Starter — 1 farm, 3 seats, 50 active batches (spawn + blocks), 5 locations. Daily & weekly reports. $9.99/mo.
Entrepreneur — 1 farm, 10 seats, 150 active batches (spawn + blocks), 10 locations. Daily & weekly reports. $14.99/mo.
Multi-Farm — 3 farms, 25 seats, unlimited batches, unlimited locations. Daily & weekly reports. $29.95/mo.
Enterprise — custom limits, white-label optional; contact sales.

Upgrade from Settings → Plans & Billing. (Managers only.)

2. Getting Started

2.1 Creating an Account

Open the registration page.
Enter your name, email, and a password (at least 8 characters).
If you received an invite, paste the token. Otherwise leave it blank for a free signup.
Optional: tick Get product updates by email to hear about new features and growing tips. You can change this anytime in your User Profile.
Submit. A new farm is created automatically and you become its Manager.

2.2 Logging In

Open the login page.
Enter your email and password.
If you belong to multiple farms, pick one from the dropdown that appears in the header after login.

2.3 The Welcome Tour

The first time you log in, a 9-step tour walks you through the parts of TurboBatch you'll use most: Batch Control, batch types (Spawn Bag vs Fruiting Block), Calendar, Strain Library, Avery Labels, Brand & Theme, and Email Reports. You can skip it or step through at your own pace.

Want to see it again later? Open this Help drawer and click Take the Tour in the toolbar at the top.

2.4 Forgot Your Password

On the login page, click Forgot password?
Enter your email and submit.
Check your inbox for the reset link. The link is good for one hour and works once.
Click it, choose a new password, then sign in normally.

2.5 Switching Farms

Use the Farm dropdown at the top of any page. The app reloads with that farm's data.

2.6 Getting Help

Click the ? icon in the header on any page, or open Settings → Help. The Help drawer opens with this guide and a contact form at the bottom — see Help & Support for what to put in each field.

3. Batch Control

Batch Control is your daily operations screen. The header shows a live clock, today's date, current weather, and a 4-day forecast for the farm's location. Below the header you'll find the live Strains Live ticker, the 6-card telemetry strip, the Pit Stop Alerts panel, the Create Batch card, and the Batch Garage.

3.1 The Mushroom Profile Card

When you pick a strain in Create Batch, the right side of the card shows that strain's profile: photo, summary, Spawn / Fruiting target temperature, Spawn / Fruiting target relative humidity, target CO₂, target light, and cycle timing (Spawn → Block Colonization → Fruiting). Use this to confirm the room conditions and timing match the batch type and strain you're about to start.

3.2 Creating a Batch

In Create Batch, pick the Batch Type (see 3.3 below).
Pick the strain.
Set the inoculation date (defaults to today).
Enter the number of bags.
Pick a location for where the bags are going (optional).
Click Start Batch.

TurboBatch generates the batch ID for you. Spawn Bag IDs are prefixed with S- (e.g. S-2026-05-12-1); Fruiting Block IDs use the species' first letter (e.g. L-2026-05-12-1 for Lion's Mane), so the two stand out at a glance.

3.3 Batch Types

Every batch is either a Spawn Bag or a Fruiting Block. Pick the type at creation time — the lifecycle, status flow, and Pit Stop Alert wording change accordingly:

Fruiting Block — supplemented sawdust substrate destined for fruiting. Goes Colonizing → Fruiting → Harvested. Uses the strain's Block Colonization Days + Fruiting Days in Strain Manager. (Incubation and pinning are treated as one stage — the colonization clock runs right up to the point you move the block to fruiting.)
Spawn Bag — sterilized oats (or other grain) used as inoculation media for Fruiting Blocks. Goes Colonizing → Used (no fruiting stage). Uses the strain's Spawn Colonization Days in Strain Manager. Pit Stop Alerts say "Ready to use" instead of "Move to fruiting" once colonization completes.

Both types count toward your plan's active-batch allowance. Filter the Batch Garage by type using the Filter by type dropdown in the toolbar.

3.4 Batch Lifecycle

Status flow depends on the batch type:

Fruiting Block: Colonizing → Fruiting → Harvested (with Discarded as a side exit for failed batches). Incubation and pinning are treated as one stage, so the colonization clock runs until you move the block to fruiting. The app prompts you to move the batch to a fruiting tent when you switch to Fruiting, and asks for total wet weight when you switch to Harvested.
Spawn Bag: Colonizing → Used (or Discarded). The "Used" option is the same underlying status as "Harvested" — it just reads as "Used" on Spawn Bag tiles since consuming a spawn bag means inoculating Fruiting Blocks with it.

3.5 Locations

Pick a location for each batch from the dropdown on its tile.
Filter the Batch Garage by location using the toolbar dropdown.
Bulk move: tick the checkboxes on multiple batches and use Bulk Move in the toolbar to move them all at once.

3.6 Logging Harvest Weight

The prompt appears the first time you switch a Fruiting Block to Harvested. Spawn Bags don't prompt for a weight — they're inoculation media, not a harvest.
Enter the total wet weight for the batch. The unit (lb or kg) follows your farm setting.
Skip if you don't have the number — the batch still moves to Harvested.
Edit later by clicking the ✎ pencil button on the batch tile.

3.7 Audit Trail — Who Did What

Every batch keeps a record of significant actions and who performed them. The bottom of each batch tile shows a one-line summary of the latest event ("Sara · moved to Fruiting · 2h ago"). Click it to expand the full timeline:

Who started the batch
Who moved it to Fruiting (and when)
Who harvested (and the weight they logged)
Who moved it between locations
Who logged or corrected the harvest weight after the fact

If a team member is later removed from the farm, their name stays attached to past events for accountability — historical actions never become anonymous.

3.8 Pit Stop Alerts

The Alerts panel highlights batches that are overdue, due today, or due soon. The list shows up to six rows at a time and scrolls when there are more. When everything is on track, you'll see the Track Clear graphic.

3.9 Sprints: One-Click Batch Runs

A Sprint is a reusable template for a run of work you repeat, like "every Tuesday" or "every Thursday." Each Sprint is a list of strains and how many bags of each. Open Sprints in the top nav, pick an inoculation date, and click Create batches. TurboBatch creates one batch per line (Fruiting Blocks starting at Colonizing), then Print labels jumps to the Label queue with exactly those batches pre-selected, ready to print before you start.

Edit anything. Change bag counts, add or remove strains, or rename a Sprint, then click Save changes.
+ New sprint builds one from scratch. Delete removes a Sprint template; batches you have already created are never affected.
New farms start with two example Sprints you can keep, edit, or delete. Every farm member can create and edit Sprints.

4. Dashboard

The Dashboard shows the farm at a glance.

Strains Live ticker — scrolling strip between the Race Hero and the telemetry tiles. Each line is a real strain on the farm with its live counts (active batches, bags, harvest weight). A farm-level rollup leads and an all-time harvest rollup tails the loop, so a single-strain farm still scrolls with substance.
Telemetry tiles — Active Batches, Active Bags, Due Today, Overdue, Harvest 30 days, Harvest All-time. The Active Batches and Active Bags tiles each carry a small "X block · Y spawn" sub-line so you can see the mix between Fruiting Blocks and Spawn Bags without opening the Garage.
Pit Stop Alerts + Activity — what needs attention now alongside the last 8 weeks of new-batch activity.
Lifecycle Pipeline — where every active batch sits across Colonizing → Fruiting → Harvested.
Stage Distribution — donut breakdown of all statuses.
Performance — twin gauges showing average colonization and fruiting completion across active batches.
- Colonization gauge: green low → red high. Spawn run is going smoothly when most batches sit on the green side; red means a lot of batches are deep into colonization and need a fruiting decision soon.
- Fruiting gauge: red low → green high. The needle climbing into green means batches are approaching harvest — the direction you want.
Harvest Performance — total harvested, average per bag, and which strains contributed the most weight.
Batch Progress — per-strain progress bars for everything currently running.
Strain Leaderboard + Location Utilization — active bags by strain and by tent.

The Dashboard refreshes itself in the background as new data comes in.

5. Calendar

The Calendar lays out batch milestones across the timeline. Click any day to see what's scheduled in the sidebar; the Upcoming panel previews what's next. Today is highlighted in the grid. The Farm Activity ticker at the top scrolls recent operational events.

Event types in the calendar legend:

Inoculation — a Fruiting Block was started. The detail panel shows when it's projected to move to fruiting.
Inoc Spawn — a Spawn Bag was started. The detail panel shows when the spawn will be Ready to use.
Move to Fruiting — the projected end of block colonization, when the block is ready to move to fruiting. Fruiting Blocks only.
Spawn Ready — the projected end of grain colonization on a Spawn Bag. The bag is ready to inoculate Fruiting Blocks. Terminal — Spawn Bags don't have a fruiting or harvest event after this.
Harvest / Check — the projected harvest day for a Fruiting Block.
Discarded — a failed batch.

6. Printing Labels

TurboBatch prints to Avery 48660 sheets — 30 labels per sheet (3 columns × 10 rows). Each label has the farm logo, strain, inoculation date, bag number, and a scannable QR code that jumps straight to that batch (see 6.3 Scanning Labels). Spawn Bag labels carry a small SPAWN marker next to the bag number so they don't get mixed up with Fruiting Block labels on a packed shelf.

6.1 The Print Queue

The Batch Print Queue groups your batches by inoculation date in collapsible panels. The most recent date opens by default; older dates start collapsed to keep things tidy. Each date group has a checkbox in its header that selects every batch in that group at once.

Clicking Labels on a batch tile in the Batch Garage deep-links straight here with that batch pre-selected — no need to scroll the picker.

Creating a Sprint's batches drops you here the same way, with the whole run pre-selected. Tick nothing, just print.

6.2 Printing

Tick the batches (or whole date groups) you want to print.
If you're reusing a partially-used Avery sheet, set Start at to the first available label position.
Click Print Selected.
In your browser's print dialog, set Margins to Default and Scale to 100% (don't use "fit to page").

Multi-page jobs (more than 30 labels) handle margins automatically on every page.

6.3 Scanning Labels

Because every label carries a QR code, a label is a shortcut back to its batch. Open Scan — in the toolbar and the More menu — to launch the built-in scanner. It opens your device camera right in the app; point it at any label's QR and TurboBatch drops you straight onto that batch's editor, ready to change status, location, dates, or bag count on the spot. No walking back to a computer, no hunting through the Garage for the right tile.

It's built for the phone in your hand out in the grow room. Fruiting Blocks and Spawn Bags both print a scannable QR. And if you scan a label on a phone that isn't signed in yet, TurboBatch brings you right back to that batch after you log in.

7. Settings

Most Settings cards are Manager-only. Operators see them read-only or hidden.

7.1 Brand & Theme Manager

Farm Identity — Farm Name, Timezone, Time Format (12 or 24 hour), Weight Units (lb or kg).

Farm Logo — upload a PNG, JPG, or WebP image up to 2 MB. Your logo appears in the app navigation and on every label you print.

Theme Colors — customize the workspace colors for this farm. The color pickers preview live; click Reset to Default to revert to the TurboBatch palette.

7.2 Email & Reporting Manager

The Email panel has the configuration form on the left and a live preview of the report on the right.

Turn email on, set the recipients.
Toggle Daily Digest and Weekly Report on or off. Daily reports require a paid plan (Starter and above). Free plans get the Weekly report only.
Tune the alert toggles: Overdue, Due Today, Due Soon Window (in days).
Use the Daily / Weekly tabs in the preview pane to see exactly what your recipients will receive. Click Refresh to update the preview after changing data.
Send Sample Daily / Send Sample Weekly dispatch a real email to your recipients (or to a single address you type in the override field). The subject is tagged [Sample] so it's never confused with a scheduled one.

Reports go out automatically at scheduled times — once your settings are saved, you don't need to click anything.

Daily report — today's overdue, due-today, and due-soon batches plus any new batches started today.

Weekly report — this week's new batches, harvest totals (this-week and all-time), top strains by harvest weight, the seven-day lookahead, and a Team Activity table showing who started, moved-to-fruiting, harvested, and moved batches over the past 7 days. The table also lists each team member's total harvested weight for the week.

7.3 Plans & Billing Manager

The current-plan summary shows how many farms, seats, batches, and locations you're using against your plan's limits.
Each plan tile shows the monthly price and feature list.
Click an upgrade tile to open the secure payment page in a new window. After payment, the page returns and refreshes — your new limits take effect immediately.
Use the Manage billing link to change your card, update billing details, or cancel.

7.4 User Profile

Available to every user — Manager and Operator.

Update your name, email, and password. New passwords need to be at least 8 characters.
Marketing emails — opt in or out of product updates and growing tips. Off by default (CAN-SPAM compliant); you choose whether to hear from us.

7.5 Manage My Account

Available to every user.

Download My Data — exports a single file with everything we hold for your account: your user record, every farm you have access to (with batches, strains, locations, settings), and your licenses.
Delete My Account — irreversible. You'll need to type your password and the word DELETE to confirm. Farms where you're the only Manager are deleted with their data; farms with other Managers just lose your access.

7.6 Team Management Manager

Managers manage the people on their own farms — who has access and at what role, plus the invite tokens that bring new team members on board.

Existing Users — list users on your farms, assign or change their per-farm role (Manager or Operator), or remove them from a farm.
Add User — invite a new team member directly by email, assigning them a role on a specific farm.
Licenses / Invite Tokens — create invite tokens to onboard new team members at scale. Tokens can be single-use or reusable, and can be tied to a specific farm and role.

7.7 Strain Manager Manager

Each strain in your library has three integer day fields — Spawn Colonization Days, Block Colonization Days, and Fruiting Days — plus a rich Mushroom Profile (Common Name, Scientific Name, Spawn / Fruiting Target Temperature, Spawn / Fruiting Target Relative Humidity, Target CO₂, Target Light, day ranges, Total Cycle, Difficulty, Image Search Query, Aliases, Summary).

The day fields drive different parts of the lifecycle:

Spawn Colonization Days — used when you create a Spawn Bag batch (sterilized oats). Drives the "Ready to use in Xd" countdown.
Block Colonization Days — used when you create a Fruiting Block batch. Drives the "Move to fruiting in Xd" countdown. Incubation and pinning are treated as one stage, so set this to the full time from inoculation until the block is ready to fruit.
Fruiting Days — used only by Fruiting Blocks after they enter the Fruiting status. Drives the "Harvest/check in Xd" countdown.

+ Add Strain — adds a new row at the top of the grid with the Name field focused. Type a recognized strain name and click out. The Mushroom Profile fields fill in automatically from the bundled data, and the entry saves itself in the background.
Apply Scientific Defaults — refreshes every strain in your library from the latest scientific data. Use this after we ship updates to the bundled profiles. Review the values, then click Save.
Midpoints Only — fills the day-count numbers (Spawn / Block Colonization, Fruiting) as midpoints of each strain's range. Doesn't touch the rest of the profile.
Per-strain ⚗ / ≡ icons in the top-right corner of each card — same actions scoped to a single strain. Both confirm before overwriting.
Save on each card — explicit save for any manual edits to that one strain.

7.8 Environmental Sensors — AC Infinity Manager

If you run AC Infinity WiFi controllers (the Controller 69 family and similar), you can connect your account and stream each controller's live temperature, humidity, and CO2 straight into TurboBatch (CO2 shows wherever your controller has a CO2 sensor). Mapped readings feed the dashboard's Climate Compliance card, so every batch is checked against the actual room conditions instead of a number you typed in once.

Connecting your account

Open Settings → Environmental Sensors and enter the same email and password you use in the AC Infinity phone app, then click Connect.
Your password is encrypted and stored only so TurboBatch can keep reading your sensors. TurboBatch never changes your controller, fan, or program settings — it only reads. You can disconnect anytime, which deletes the stored login.

Mapping controllers to locations

After connecting, each location gets a dropdown of sensor sources. Each controller offers its Built-in sensor and, if you have an external probe plugged in, a Probe (Port N) source. The dropdown shows each one's live reading, so pick the one that matches what you see in the AC Infinity app — usually the probe hanging in the chamber, not the controller's built-in sensor.
The selected reading appears next to the location. Choose — Not mapped — to remove a mapping.
Readings refresh automatically while the panel is open, and in the background if the sensor cron is scheduled. Click Refresh to pull the latest immediately.

Facility ambient (header). If you have a probe placed outside the tents reading your room/facility conditions, pick it under Facility ambient and its temperature, humidity, and CO2 show in the app header next to the weather forecast, across the app. It's display-only — it doesn't change Climate Compliance. Leave it on None to keep the header as-is.

On the dashboard. The Climate Compliance card shows a live strip of each connected room's temperature, humidity, and CO2, and grades batches in mapped locations against their strain's target using the real sensor reading. A pulsing dot means the reading is live; an amber dot means it's gone stale or the controller is offline.

Note — Readings are informational and can lag or drop out if AC Infinity's cloud is unreachable. Keep your controller's own alarms on as the real safeguard for a grow.

7.9 Costs & Pricing Manager Entrepreneur+

Two optional numbers turn your farm's own loss and harvest data into dollars — with no per-strain pricing. TurboBatch does the math from your yield history.

Production cost per bag — your all-in cost to make one block (substrate, grain, bag, and a share of labor and power).
Average sale price ($/lb) — one blended retail price across your strains.

Once set, a Money · last 30 days panel appears on your Dashboard scorecard:

Harvest value — what you grew, at your $/lb.
Cost lost — the production cost sunk into contaminated and no-yield bags.
Revenue lost — the sales those lost bags would have made.

When you remove a bag in Batch Control and mark it Contaminated or No yield, the estimated loss (“~$X in lost sales · ~$Y sunk”) shows right on the choice, so the cost of a loss is visible the moment it happens. Silent Mistake removals never show a loss.

Availability — the money view is included on the Entrepreneur, Multi-Farm, and Enterprise plans. On other plans the card shows an upgrade link instead.

8. Mushroom Profile Library

TurboBatch ships with curated profiles for the most commonly cultivated mushrooms. Each profile is written for growers who already know the species — short summaries focused on operational decisions (pin signals, harvest cues, common pitfalls) rather than basic species background. Bundled species include:

Lion's Mane (four species: H. erinaceus, H. americanum, H. coralloides, H. abietis)
Oysters — Blue, Snow, Italian/Phoenix, Grey Dove, Pink, Golden, King Trumpet, Elm
Shiitake, Chestnut, Nameko
Enoki, Shimeji (Beech), Pioppino
Maitake (Hen of the Woods), Reishi, Turkey Tail, Cordyceps militaris
King Stropharia (Wine Cap), Wood Blewit

If you grow something not in the list, your Manager can add it to the Strain Manager and fill in the profile fields manually.

9. Help & Support

The Help drawer is reachable from the ? icon in any page header. The toolbar at the top of the drawer jumps to specific sections of this guide and includes a Take the Tour link to replay the 9-step welcome tour.

At the bottom of the drawer is the Need a hand? Tell us. form. Pick the type that fits and we'll handle it accordingly:

Support — something isn't working for problems blocking your day-to-day work. We'll prioritize and reply.
Bug report for something behaving incorrectly but not blocking. Include the page you were on and what you expected to see.
Feature request for new capabilities. Tell us the problem you're trying to solve, not just the feature — it helps us design the right fix.
General comment for anything that doesn't fit the above.

Typical response is within one business day at support@turbobatchmushrooms.com.

10. Best Practices

Use one farm per physical operation. Don't share farms across distinct sites.
Set the farm timezone correctly so cycle dates and report timestamps are accurate.
Log harvest weights as you go — the dashboard yield charts and weekly report rely on it.
Keep locations up to date so the Location Utilization chart reflects what's actually in each tent.
Reusing a partial Avery sheet? Always set the Start at offset before printing.
After changing email settings, click Send Sample to confirm delivery before the next scheduled report.
Have at least two Managers per farm so no one is locked out if a Manager leaves the team.
Operators: when you hit "Access denied" on something, ask a Manager — don't try to work around it. The role boundaries protect your data.

11. Troubleshooting

Labels printing in the wrong position

Confirm you're using Avery 48660 (or the compatible 48860).
Browser print dialog: set Margins to Default, Scale to 100%. Never use "fit to page".
If you reused a partial sheet, double-check the Start at position is correct.

Email reports not arriving

Open Settings → Email & Reporting and confirm Email Enabled is Yes and the recipient list is set.
Click Send Sample Daily (or Weekly) with your own address in the override field. If it lands, scheduled reports will too.
If samples don't land, check your spam folder.
If you're on the Free plan, only the Weekly report is sent — Daily is a paid feature.
If your subscription went past-due or canceled, paid reports pause until billing is current again.

The Welcome Tour isn't showing up for a new team member

The tour fires once per user account on first login. If your team member already dismissed it (intentionally or not), they can replay it any time from the Help drawer → Take the Tour link in the toolbar.

The Strain Ticker isn't moving

Check that you have active batches. The ticker only scrolls if there's something to show — a brand-new farm with no batches yet will still display the FARM rollup and the all-time harvest tail, but those won't scroll meaningfully until you create some batches.

Missing data after switching farms

Confirm the correct farm is selected in the header. Each farm is fully isolated, so batches in one farm don't appear in another.

Access denied on a feature

Settings, billing, and team management require Manager role on the current farm. The error message names your current role and the role needed. If you should have Manager access, your farm's existing Manager can promote you in Settings → Team Management.

Strain profile shows "Use farm SOP" instead of real targets

Ask your Manager (or do it yourself if you're a Manager) to open Settings → Strain Manager.
Click Apply Scientific Defaults. This refreshes any strain whose profile is still on the placeholder.
Review the populated fields, then click Save Strain Timings & Profiles.

Reset link expired

Reset links last one hour and are single-use. Request a new one from Forgot password? on the login page.

Plan upgrade succeeded but my limits haven't updated

Upgrades take a moment to register. Refresh the page, and your new limits will appear.

TurboBatch — Production, clearly tracked.