Recipes
Define substrate formulas, inoculation parameters, and fruiting conditions for your mushroom varieties.
Recipes
A recipe is the technical specification for a mushroom grow. It defines the substrate formula, target weights, sterilization method, inoculation approach, incubation conditions, and fruiting environment for a specific species and strain. Every batch you create must reference a recipe.
Recipe List
Navigate to /recipes to see all recipes for your farm. Click any recipe row to open its detail page.
Creating a Recipe
Go to /recipes/new or click New Recipe from the recipe list.
The creation page offers two modes — switch between them with the button in the page header:
- Wizard (default) — a guided step-by-step flow that walks you through each section and helps you build a complete, high data-health recipe
- Quick Create — a single-page form with all fields visible at once
Basic Information
| Field | Required | Description |
|---|---|---|
| Name | Yes | A human-readable recipe name (for example, Lion's Mane - Oak Block) |
| Species | Yes | The mushroom species (for example, Hericium erinaceus) |
| Strain | Yes | The specific strain or cultivar name |
| Bag Type | No | Reference to a bag type record from /bag-types |
Weight and Ratios
| Field | Description |
|---|---|
| Target Wet Weight (g) | The target total weight of the filled bag before sterilization |
| Hydration (%) | Target moisture content of the substrate mix |
| Supplement (%) | Percentage of nutritional supplement relative to dry substrate weight |
Ingredients
The ingredients list defines the substrate formula. Each ingredient has:
- Name — the material (for example,
Oak Sawdust,Wheat Bran,Gypsum) - Amount — quantity in the specified unit
- Unit — the measurement unit (for example,
g,kg,lbs,cups) - Lot Tracking Required — when enabled, batch creation for this recipe will require lot information for this ingredient in the Input Lots section
You can add as many ingredients as needed. A recipe with no ingredients is valid but will have a lower data health score.
Sterilization Parameters
| Field | Description |
|---|---|
| Method | Sterilization method (for example, Autoclave, Steam) |
| Target Temp (C) | Target temperature in Celsius |
| Hold Time (min) | How long to hold at temperature |
| PSI | Pressure in pounds per square inch |
Inoculation Parameters
| Field | Description |
|---|---|
| Spawn Type | The type of spawn being used (for example, Grain, Sawdust, Liquid Culture) |
| Spawn Rate (%) | Spawn weight as a percentage of substrate weight |
Incubation Parameters
| Field | Description |
|---|---|
| Target Days | Expected colonization time in days |
| Temp Range (F) | Minimum and maximum incubation temperature in Fahrenheit |
The target days value is used by the dashboard to identify blocks that may be overdue for transition.
Fruiting Parameters
| Field | Description |
|---|---|
| Temp Range (F) | Minimum and maximum fruiting chamber temperature |
| Humidity Range (%) | Minimum and maximum relative humidity |
| FAE Target | Fresh air exchange setting or schedule |
| Light Schedule | Light cycle description (for example, 12/12, 16/8) |
Editing a Recipe
From the recipe detail page, click Edit to open /recipes/{id}/edit. All fields are editable. Changes apply to future batches — existing blocks that reference this recipe are not retroactively changed.
When your farm has turned on Planning, the form also has a Planning section: Buffer (units), Rack size (units) and Lead time (days). See Planning.
Deleting a Recipe
Click Delete on the recipe detail page. A confirmation modal will appear. Deletion is permanent and removes all parameter configurations for the recipe. You cannot delete a recipe that is referenced by an active batch.
Recipe Detail Page
The detail page at /recipes/{id} organizes recipe data into collapsible cards:
- Basic Information — species, strain, bag type, created by, dates
- Weight and Ratios — target wet weight, hydration %, supplement %
- Ingredients — table with name, amount, unit, and lot tracking status
- Sterilization Parameters — shown only if configured
- Inoculation Parameters — shown only if configured
- Incubation Parameters — shown only if configured
- Fruiting Parameters — shown only if configured
Cards for optional sections only appear when that data has been filled in. A recipe with all sections completed will score higher on the data health assessment.
Recipe-to-Batch Relationship
When you create a batch, you select one recipe. The recipe_id is stored on every block in that batch. This enables per-recipe yield analysis in the Yield by Recipe report, which shows average yield across all batches using the same formula.
Permissions
| Action | Minimum Role |
|---|---|
| View recipes | Viewer |
| Create recipe | Manager |
| Edit recipe | Manager |
| Delete recipe | Manager |
Related Pages
- Batches — each batch requires a recipe
- Your First Batch — create the bag types that recipes use
- Reports — the Yield by Recipe report compares yield across recipes
- Planning — how many of each recipe to start, and when