One guide per area: what you'd build with it, the functions to call first, and a worked example whose numbers are checked by the tests.
The formulas behind the numbers, where each one comes from, and what it leaves out.
A whole recipe in, every number out. Start with calculateRecipe, then recipeChecks for what's worth knowing before brew day. The recipe's input types, the equipment profile and the engine-wide defaults live here too. See the Recipe guide.
Extract, efficiency, original and final gravity, attenuation, ABV and calories, the volume waterfall, and the corrections for hydrometer and refractometer readings. Start with abv, correctHydrometerReading, refractometerFinalGravityRaw and planVolumes. The Recipe guide has them in use.
Bitterness by Tinseth, Rager or Garetz, whirlpool and hop-stand additions, and the alpha acid a hop loses in storage. Start with calculateIbu and agedAlphaAcidPercent. See the Hops guide.
Malt color units to SRM by Morey, Daniels or Mosher, conversions between SRM, EBC and Lovibond, and a hex swatch for the beer. Start with calculateColor and srmToHex. The formulas are on the Gravity, IBU and color page.
Water profiles, salt and acid additions, two salt solvers, and a mash pH prediction from the grist. Start with solveWaterRule or solveWaterProfile for the salts, applySalts for salts the brewer chose, and predictMashPh for the pH. See the Water and mash pH guide.
Pitch rates, cell counts, viability by age, starters and dry-yeast sachets. Start with pitchPlan and planStarter. See the Yeast and starters guide.
Sizing each decoction pull from a heat balance, and planning a whole schedule. Start with decoctionPull and planDecoctions. See the Decoction guide.
COâ‚‚ volumes from temperature and pressure, priming sugar, and sulfite and sorbate doses. Start with primingSugar and pressureFromCo2Volumes. See the Packaging guide.
Blends of finished beers, the Pearson square, mead and cider musts with their nutrient schedules, and proofing and sweetening a spirit. Start with evaluateBlend, pearsonSquare, sugarToGravity and proofAndSweeten. See the Blending, mead and spirits guide.
A recipe's flavor profile on three wheels (malt, hops and fermentation), and how well it fits a style's bands. Start with flavorProfile, then flavorFit.
The engine works in kilograms, liters, °C and specific gravity. These convert at the edges. Start with sgToPlato and gallonsToLitres, and see Start here for which unit each field expects.
The working behind every headline number, and the bibliography it cites. Start with the Explanation type, then referenceExplanations for every explanation of one worked example. Start here shows how to display one.
The brewing calculation engine behind Beerwright.
It's plain TypeScript with no DOM, no I/O and no framework, so it runs the same in a browser, a Cloudflare Worker or a test runner.
Every function works in one set of units: kilograms, liters, degrees Celsius, specific gravity and ppm. Convert at the edges with the functions in the Units category.
Start at calculateRecipe. It runs the other modules and returns the recipe's numbers, with an explanation of how each one was worked out. The Start here guide walks through it, and through the units and defaults the rest of the package shares.