Getting started
Beerwright runs at app.beerwright.com. There is nothing to install and nothing to configure before you start.


You do not have to sign in first
Section titled “You do not have to sign in first”You can start using the app right away. Your workspace is saved in the browser on the device you’re using, and every calculation runs on that device, so a guest workspace has everything a signed-in one does. The sync indicator in the sidebar reads Guest — Saved on this device only.
The only thing signing in adds is syncing your recipes across devices. Everything else is the same, and you can keep using Beerwright without an account for as long as you like.
Signing in
Section titled “Signing in”There are three ways to sign in, and none of them uses a password. We don’t store passwords, and there’s no password field anywhere in the app.
A magic link. Type your address, press Email me a sign-in link, and open the link in the message. It expires in fifteen minutes and works once. The confirmation screen shows the address you typed, for example “Check you@example.com”, so you can spot a typo before you go looking in the wrong inbox.
A passkey. If your browser supports them, Sign in with a passkey sits below the email field, and your saved passkey may also appear in the email field’s own autofill list. A passkey is a key your device creates and keeps, and you use it with a fingerprint, your face or your screen lock. We only store the public half, so there’s nothing on our side that someone could steal and use to sign in as you. Add one from Settings → Sign-in once you are signed in; you can add several, one per device, and remove any of them at any time. Removing the last one is safe, because a sign-in link to your email address always works. Adding a passkey needs a recent sign-in, so if you have been signed in for more than a day the app will ask you to sign in again first.
Google. If the deployment has Google sign-in configured, a Continue with Google button sits below the email field. If it does not, the button is not shown.
The link brings you back to the app signed in. The sidebar footer now shows your address and your plan, and the sync indicator moves from Connecting to Syncing to Synced.
If you had already made recipes as a guest
Section titled “If you had already made recipes as a guest”Signing in to an account that already has a synced workspace does not merge the two, and does not throw either away. You see the synced workspace, but the recipes you made while signed out are still on the device, and signing out shows them again. We let you know when this happens.
Your first recipe
Section titled “Your first recipe”Press New recipe in the header, or Create your first recipe in the empty state, or open the command palette with ⌘K and choose New recipe. All three do the same thing in one step, so ⌘Z undoes the whole creation.
If you would rather look at a finished recipe first, the empty state also has Try a recipe. It opens a clone of Sierra Nevada Pale Ale, built from the homebrew recipe the brewery published and sized for your default batch and equipment profile, so the numbers you see are the numbers your rig would make. After that it’s an ordinary recipe. You can change it, brew it, or delete it, and ⌘Z takes it away again in one step.
Wherever these pages print ⌘, Ctrl presses the same on Windows and Linux, and the app’s own labels show whichever your keyboard has.
You land straight in the editor on a recipe called Untitled recipe, with:
- no style set, batch size 5 US gal, 60 minute boil
- the Generic 5 gal all-grain (cooler + kettle) equipment profile, with 75 % mash efficiency and 70 % brewhouse
- a target carbonation of 2.4 volumes
- one mash step, Saccharification, 66 °C for 60 minutes, or for your Default mash time if you have changed it in Settings
- one fermentation step, Primary, 20 °C for 14 days
- empty ingredient lists
Efficiency comes from the equipment profile, so changing rigs changes the numbers on every recipe you brew on it. A recipe that needs a different figure can override it in its own header.
The empty state tells you the one thing you need to know to start, which is to press A in the editor to search the catalog.
A tour of the editor
Section titled “A tour of the editor”The editor is a single scrolling column of panels, with no tabs, and a sticky vitals rail down the right. On a phone the rail becomes a bar docked to the bottom that expands when you tap it.
The header
Section titled “The header”You edit the recipe name in place. Type, then press Enter to save or Escape to cancel. Beside it sit Style, Batch, Boil and Equipment, then Scale and Brew. The overflow menu has the actions for the recipe as a whole: shopping list, print brew sheet, version history, share, duplicate, export as BeerJSON, delete.
The panels
Section titled “The panels”In order: Fermentables, Hops, Yeast, Misc, Mash schedule, Fermentation schedule, Water & mash pH, Packaging and Notes. On a wide enough screen the two schedules sit side by side. Every one of them updates on every edit, including the salt suggestions and the mash-pH prediction, and none of them needs a server.
The vitals rail
Section titled “The vitals rail”Five bars, OG, FG, IBU, SRM (or EBC, if that’s your unit) and ABV, show your recipe against the BJCP range for the style you picked, so you can see whether you’re in style without looking it up. Below them are the color swatch with its MCU and the model that produced it, a mash pH strip, the flavor wheels and the checks, then BU:GU, Calories, CO₂ and Pre-boil just above the volume waterfall from strike water to packaged beer.
Every headline number has an explain popover behind it, showing how that number was worked out and offering to ask the assistant about it. If a figure ever looks wrong, that popover is the first place to go.
The assistant
Section titled “The assistant”⌘J opens the assistant drawer. It reads your actual recipes and works from the same numbers you see, and it never changes anything on its own. When you ask for a change, it comes back as a proposal card with a summary, the reasoning, a checkbox per individual change, and a before-and-after diff of the vitals colored against the style range. You press Accept all, or check some of the changes and press Accept 3, or Reject.
We apply an accepted proposal as one change, so ⌘Z undoes all of it.
If the recipe changed after the proposal was drafted, we flag it on the card and offer to check again, so you don’t apply advice that’s out of date.
Getting around
Section titled “Getting around”⌘K opens the command palette: your recipes by name, style or tag, the actions (new recipe, undo, redo, theme, units) and every page in the app.
⌘Z and ⇧⌘Z undo and redo across the whole workspace, not just the field you are in. The history is long, but it’s cleared when you reload the page, and delete confirmations remind you of that.
Saving
Section titled “Saving”There’s no Save button and no “Saved” label, because there’s nothing to wait for. We save your edits in the browser as you make them, and if you’re signed in we also send them to your account. The sidebar’s sync indicator is the only status, and it’s worth reading what it says when the connection drops before it happens.
Keeping the list short
Section titled “Keeping the list short”A recipe you are finished with does not have to be deleted to get out of the
way. Archive it, from the row’s menu, from the recipe’s own ⋯ menu
while you have it open, or by checking several and pressing Archive in the
bar along the bottom, and it leaves the list. The Archived chip appears above
the list with a count; press it and the list becomes your archive, with
search, tags and the row menus all working as usual. Restore puts one
back.
Archiving changes what the list shows and nothing else. The recipe still syncs and still exports, and any share link or gallery listing pointing at it keeps working. It also still counts toward the recipe limit on the free plan, so archiving tidies the list but doesn’t free up space.
Checking the boxes on rows brings up a bar along the bottom of the window, which stays in view as you scroll down the list. It acts on everything you have checked: build one combined Shopping list, Add tags, Export as BeerJSON, Archive, or Delete. Tags are added to what each recipe already has rather than replacing them, and each action is a single step, so one undo takes back all of it. The ✕ at the end of the bar clears the checkmarks without changing anything.
Sorting by Style puts the list in BJCP guideline order and heads each style as it goes, so all your 21A American IPA recipes sit under one label and anything without a style goes at the end under its own label.
Where to go next
Section titled “Where to go next”- Your first recipe, the five-minute walk with pictures.
- Importing recipes, to bring a library across from another tool.
- Water chemistry, the panel that does the most for you.
- The recipe editor, every panel, in depth.
- On a phone or tablet, for installing it and what changes.
- FAQ, short answers to the things that come up most.
Related
Section titled “Related”- Your first recipe, the same walk with every number explained.
- The recipe editor, panel by panel.
- Keyboard shortcuts, for the five keys and the command palette.
Something wrong on this page? Tell us.