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.
Workflow
What the ratio calculates
Examples with a 0.9 L/kg ratio
Knockout · new yeastWeight entryVolume entry
For 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 yeast
Converts 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 task
Converts 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
Open Production > Settings > Brewery and find Liquid yeast conversion ratio.
In the new row, enter Effective since and Litres per kg, then select Add ratio.
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.
Fictional transactional fixtures; these record IDs do not persist after the tests.
The two settingsFrame 02
Set the product stock conversion
This liquid yeast is stocked in kg and can be entered in mL when brewing. Its product conversion is 0.8 L/kg, so 800 mL consumes 1 kg of raw material stock.
Fictional transactional fixtures; these record IDs do not persist after the tests.
New yeast by weightFrame 03
Pitch 1 kg of new liquid yeast
The saved knockout draft contains 1 kg of liquid yeast. The brewery ratio calculates 0.9 L added to the batch, even though this product has a different stock conversion.
Fictional transactional fixtures; these record IDs do not persist after the tests.
New yeast by volumeFrame 10
Two new pitches consumed 2 kg in total
The 1 kg weight pitch and the 800 mL volume pitch each consumed 1 kg. Raw material stock is now 18 kg. Their batch volume contributions are 0.9 L and 0.8 L respectively.
Fictional transactional fixtures; these record IDs do not persist after the tests.
Changing the ratioFrame 11
Changing the ratio applies to later calculations
The brewery ratio is now 1.1 L/kg. The already saved pitches and brink balance retain the values recorded earlier. Add dated ratios to keep a history of when each rate applies.
Fictional transactional fixtures; these record IDs do not persist after the tests.
Worked examples
What each entry changes
Entry
Raw material stock
Yeast volume
Pitch 1 kg of new yeast
Consumes 1 kg of the entered weight.
Adds 0.9 L to the batch using the brewery ratio.
Harvest 10 kg into a brink
Harvest creates brink inventory.
Records 9 L in the brink using the brewery ratio.
Pitch 2 kg of harvested yeast
Uses 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 yeast
Consumes 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.
Result
Check
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.