BREWINGEngineers|Docs
Open app
Core features

Dial-in

The dial-in wizard is the heart of the app. It walks you from a bean and a grinder through logging individual shots, and diagnoses each one — telling you whether you're dialed in and what to change next.

How a session works

A dial-in session groups the shots you pull while chasing a recipe for one bean. The wizard moves through four stages: bean → grinder → shot → diagnosis. You can pull as many shots as you need; each is logged and diagnosed.

One active session per workspace
A workspace has a single active session at a time. If one is already open, the wizard resumes it instead of starting over.

Step by step

  1. 1
    Pick a bean

    Choose from your inventory, or add a new bean right here without leaving the wizard.

  2. 2
    Pick a grinder

    Your starred grinders show under “My gear”; everything else is below. You can jump back to the bean step anytime.

  3. 3
    Log the shot

    Enter dose, yield, time and grind setting, pick a scale, and note how it tasted. The grind field hints at your grinder’s range and unit.

  4. 4
    Read the diagnosis

    The app evaluates the shot and tells you if it’s dialed in or what to adjust, then pre-fills the next shot for you.

What a shot records

DoseGrams of dry coffee in the basket.
YieldGrams of espresso out.
TimeShot time in seconds.
GrindYour grinder setting, in that grinder’s own units.
ScaleWhich scale you used — it sticks across shots in the session.
TasteSour, balanced, bitter and body cues that feed the diagnosis.

The diagnosis engine

Each shot is scored against a set of espresso rules — brew ratio, shot time, taste and body, and signs of channeling. The result is one of:

  • Dialed in — the shot is within target; lock in the recipe.
  • Adjust — specific suggestions (e.g. grind finer, raise yield) with a confidence level.
  • Invalid — the numbers don’t add up (for example a missing or impossible value).

When an adjustment is suggested, the next shot is seeded with the recommended grind and yield so you can pull again immediately.

Sessions & history

  • Finish a session as “dialed” when you’re happy, or “abandon” it to stop without a result.
  • Recent sessions and shots appear on your dashboard.
  • Open the Sessions history to review every session, filtered by status (active, dialed, abandoned).
  • Each session detail shows the recipe context plus every shot with its full numbers and diagnosis.