BrewKeeper · Documentation draft · Local application · 11 November 2026

Liquid yeast ratio and
product brewing conversion

Product Brewing Conversion calculates raw material stock consumption. Liquid Yeast Conversion Ratio calculates liquid yeast volume from weight. Follow the settings, pitches and harvests using different rates to see both calculations.

11 browser capturesTemporary fictional test dataApplication 648323593
Product · 0.8 L/kg800 mL used in brewing consumes 1 kg of raw material stock.
Brewery · 0.9 L/kg10 kg of harvested liquid yeast represents 9 L in a receiving brink.
Saved values are retainedA later ratio change preserves previously saved pitch volumes and brink balances.

Where the liquid yeast ratio is used

Weight entries in kg or grams use the brewery liquid yeast ratio to calculate litres. At 0.9 L/kg, 1 kg of liquid yeast adds 0.9 L to the batch.

Volume entries in L or mL use the volume you enter directly. 1 L adds 1 L, and 800 mL adds 0.8 L.

WorkflowWhat the ratio calculatesExamples with a 0.9 L/kg ratio
Knockout · new yeastWeight entryVolume entryFor a weight entry, converts the amount pitched from raw material inventory into litres added to the batch. For a volume entry, adds the entered volume directly.Weight entry
1 kg pitched adds 0.9 L.

Volume entry
1 L pitched adds 1 L.
800 mL pitched adds 0.8 L.
Knockout · harvested yeastConverts the weight pitched into litres added to the batch. Those litres are also deducted from the source brink.2 kg pitched adds 1.8 L to the batch and removes 1.8 L from the brink.
Fermentation · Harvest Yeast taskConverts the weight harvested into litres of yeast inventory added to each receiving brink.10 kg harvested adds 9 L to the receiving brink.

Product Brewing Conversion separately determines raw material stock consumption. Dry yeast is excluded from liquid yeast volume calculations.

Configure the liquid yeast ratio

  1. Open Production > Settings > Brewery and find Liquid yeast conversion ratio.
  2. In the new row, enter Effective since and Litres per kg, then select Add ratio.
  3. To correct an existing row, edit its date or ratio and select that row's Save button.
Yeast workflow

Follow the quantities through each step

Click a screenshot to enlarge it. Use Previous and Next or the arrow keys to move between screens. Escape closes the viewer.

Verification and limits
Worked examples

What each entry changes

EntryRaw material stockYeast volume
Pitch 1 kg of new yeastConsumes 1 kg of the entered weight.Adds 0.9 L to the batch using the brewery ratio.
Harvest 10 kg into a brinkHarvest creates brink inventory.Records 9 L in the brink using the brewery ratio.
Pitch 2 kg of harvested yeastUses yeast held in the source brink.Adds 1.8 L to the batch and deducts 1.8 L from the brink, leaving 7.2 L.
Pitch 800 mL of new yeastConsumes 1 kg using the product conversion.Adds the entered 0.8 L to the batch.

Effective dates and saved records

BrewKeeper selects the latest ratio effective on or before the date of entry or recalculation. With no applicable saved ratio, it uses 1 L/kg. A future-dated ratio starts applying on its effective date. Backdated batch work uses the ratio effective when the entry is calculated.

Changing the ratio preserves saved calculations. Saving an editable, unconsumed pitch recalculates its volume using the then-current ratio. Dry yeast contributes no liquid yeast volume.

Verification

Checks behind these captures

11 real Firefox captures from temporary fictional fixtures. The application capture run passed 1 test with 36 assertions, zero failures and zero errors.

ResultCheck
passed Application walkthrough
36 assertions check live browser values, saved pitch volumes, the completed harvest and physical stock movements.
passed Screenshot review
Settings, pitches, harvest and stock results were visually inspected. Pitch images capture the rendered yeast section directly.
passed Gallery interaction checks
All 11 gallery images load. Four workflow previews, including the mL example, open the correct screenshots with working navigation. Chapter filters, viewer buttons, arrow keys and desktop/mobile layouts pass.
Scope and limits

Captured from local application revision 648323593. Fixtures live in the isolated agent test database and are rolled back after capture. These screenshots document the local branch.

The harvest and the final brewery-ratio edit were saved through browser forms. New and harvested pitches were staged through BatchTurn and completed through ProductionService. Application services prepared the other records. The default and date-selection rules above were checked against the code.

To reproduce, run bin/rails-test-agent test /tmp/yeast-ratio-storyboard/report/capture_test.rb with the environment recorded in progress.md. Capture dates are recorded on each image card.