Guide

Create a Recipe and Plan a Batch

Every brew day in BrewDocs starts the same way: a recipe, and a batch brewed from it. The recipe is the beer in general: what goes in it and how it's made. The batch is one particular attempt at it, with its own plan you can adjust without rewriting the recipe. This walkthrough goes from a blank recipe to a batch planned and ready to brew.

Before you start

If you haven't opened BrewDocs before, the Getting Started guide covers the four places you'll spend your time. Everything you enter lives in the browser you entered it in: nothing is sent anywhere, and nothing follows you to another device.

Step 01

Start from a recipe

Write your own from a blank page, or take a copy of one out of the catalogue.

Recipes holds the catalogue's recipes and your own in one list. To write a recipe from scratch, switch to My Recipes and choose Create. You're asked for a name and a starting template before anything exists: the template decides the equipment the recipe begins with. A kettle sour arrives with the kit a kettle sour needs, and Empty starts you with none. Confirming creates the recipe and drops you straight into its editor.

The other way in is to adapt something already written. Open a catalogue recipe and choose Edit, and BrewDocs makes you a copy to work on rather than changing the catalogue. The original stays exactly as it was, and the copy is yours to brew, edit and delete like anything you wrote yourself. The name it offers is the original's, so it's worth typing something you'll recognise later.

Either way you land on Details: the recipe's name, brewer, style and description at the top, then the measurements a brew is sized by (batch size, boil time, efficiency) and the targets you're aiming at, OG, FG, ABV and IBU. Estimated IBU sits below them and is not a field you fill in; BrewDocs works it out from the hops you've added and the batch size you brew into, so it moves as the recipe does.

The Create Recipe prompt on a phone, with a name typed in and a template dropdown reading Empty
Starting a recipe of your own: a name, and the template that decides the kit it begins with.
The recipe editor's Details panel on a phone, showing name, brewer, type and description above measurements and targets
Details, on a copy of a catalogue recipe: measurements, targets, and the estimated IBU BrewDocs works out for you.
Step 02

Lay out the ingredients

Ingredients are arranged under the phase they go into, not in one long list.

The Ingredients panel groups everything by phase first (1. Mash, 2. Boil, 3. Ferment) and then by kind within the phase. A mash offers Grains, a boil offers Hops, a ferment offers Yeasts, and every phase offers Additives, because water salts and finings are not fussy about where they land.

Grains, hops and yeasts come from a catalogue: pick a name from the phase's dropdown and confirm, and a row appears. Additives have no catalogue behind them, so you type the name instead. Confirming with the dropdown still reading "-- Select --", or with the additive field empty, does nothing at all: nothing is added and nothing is lost.

Every row carries a weight you can type over in place, and a control that removes it. Hops and additives have a little more behind them: expanding a row's details reveals a Boil time, and a hop also shows its Alpha %. A yeast's details show Attenuation % and the temperature it wants to ferment at instead. Rows stay in the order you added them. There's no reordering here, so add them in the order you'll reach for them.

The recipe editor's Ingredients panel on a phone, showing grains under 1. Mash and hops under 2. Boil, each with a weight field
Grains under the mash, hops under the boil, each with its weight, and an add row at the bottom of every group.
Step 03

Say what it's brewed with, and in what order

Equipment and Phases are the other two panels, and they answer the same question from different ends.

Equipment works phase by phase in the same shape as ingredients, but the whole catalogue is on offer for every phase. Each row is itself a dropdown seeded with the item assigned to it, so picking a different one swaps that row in place rather than adding another. Beside it is a free-text note (somewhere to write "strike at 168°F" or which of two kettles you meant), and some catalogue items arrive with a default note already filled in.

Phases is the shortest panel and the one that decides the shape of the brew. It lists every phase in order with Move up and Move down beside each; the first phase cannot move up and the last cannot move down, so those controls are shown disabled rather than hidden. Moving a phase renumbers the rest immediately. An add row at the bottom appends a new phase of whatever type you pick (Mash, Boil, Ferment, Carbonation or Conditioning), and a phase can only be removed while another of the same type still exists, so a recipe can never be left without a boil.

The recipe editor's Equipment panel on a phone, listing mash tun, stirring wand and sparge vessel under 1. Mash, each with a notes field
Equipment for the mash, each row a dropdown you can swap in place, with its own note alongside.
The recipe editor's Phases panel on a phone, listing 1. Mash, 2. Boil and 3. Ferment with move controls
Three phases in order. The first phase's Move up and the last's Move down are greyed out: there's nowhere to move them.
Step 04

Brew it into a batch

A recipe is the plan in general; a batch is the plan for one particular brew day.

When the recipe is where you want it, use Brew from the recipe's own screen. It asks what to call the batch and offers a name that counts up with the batches already brewed from that recipe (Batch #1, then Batch #2), so accepting the offer every time still leaves you with batches you can tell apart. Dismissing the prompt creates nothing.

Confirming creates the batch and takes you straight to it. The new batch arrives with the recipe's ingredients already laid out across its phases (grains in the mash, hops and additives in the boil, yeast at fermentation), carrying their quantities with them, so nothing has to be typed twice. It keeps a way back to the recipe it came from, and appears at once both in that recipe's Batches view and in your list of every batch, ready to start.

A recipe's overview on a phone with the brew prompt open, naming the recipe and offering Batch #1 as the batch name
Brew names the recipe it's about to brew, and offers the next batch number for you to accept or type over.
Step 05

Adjust the plan on Planning → Ingredients

Planning is the first tab on a batch, and it's where the general plan becomes this brew day's.

A batch opens on Planning, and Planning has three sub-tabs of its own: Ingredients, Equipment and Phases, with Ingredients shown first. It'll look familiar: it's the same phase-by-phase, kind-by-kind arrangement the recipe editor uses, working on this batch's copy of the plan rather than on the recipe.

That copy is the point. Changing a weight here, adding an additive you decided on this morning, or dropping a hop you've run out of, changes this batch and leaves the recipe alone. So the recipe stays the beer you meant to brew while the batch records the one you're actually brewing.

Ingredients and equipment stay editable however far the brew has gone, including after every phase has been checked off. If you under-poured and want the record to say so, or want to fix a typo in a note between the boil and pitching, nothing is locked.

A batch open on Planning's Ingredients sub-tab on a phone, showing grains under 1. Mash and hops under 2. Boil
The batch's own copy of the ingredients, carried over from the recipe and yours to adjust for this brew day.
Step 06

Finish with Equipment and Phases

The kit you'll actually use, and the order the brew day will run in.

Planning's Equipment sub-tab is the same idea again: the full catalogue on every phase, one dropdown per row so a swap happens in place, and a note beside it. This is where a plan meets the kit in your garage: the recipe may say a 15gal kettle, and this batch may be going into the 10gal one.

Phases is where to check the shape of the day before you start, because it's the one part of Planning that stops being editable. As soon as any phase has been marked complete on the brew-day schedule, the whole sub-tab locks: every Move, Remove and Add phase control is disabled, and hovering one explains that it's locked because a phase has already been completed. Starting the timer alone does not lock it; only completing a phase does. The schedule is built from this plan, so changing the order after work has been checked off against it would leave the record describing a brew day that did not happen.

With those three sub-tabs settled you have a plan for the day: what goes in, what it goes in with, and in what order. The Brewing tab is where you work through it.

A batch open on Planning's Equipment sub-tab on a phone, listing the mash equipment with dropdowns and notes fields
Equipment for this batch, phase by phase. Swap a row's dropdown and the kit changes without adding a line.
A batch open on Planning's Phases sub-tab on a phone, listing 1. Mash, 2. Boil and 3. Ferment with move controls and an add row
Phases, still unlocked. Once a phase is completed on brew day, every control on this sub-tab is disabled.

That's a batch planned. Brew day itself (the timer, the checkoffs and the readings you take as you go) lives on the batch's Brewing tab, and has a guide of its own: Brew Day with BrewDocs. The fastest way to make any of this stick is to open the demo and brew something out of the catalogue.