# Pizza Dough Calculator

> A free web tool that calculates precise pizza dough recipes — Neapolitan, New
> York, Roman or custom — for yeast or sourdough, using baker's percentages. It
> outputs exact flour, water, salt and yeast/starter amounts and scales to any
> number of pizzas.

The calculator is built by The Bread Code (https://the-bread-code.io). It runs
entirely in the browser, requires no sign-up, and is completely free.

## Key facts

- Works in baker's percentages: flour is 100%, every other ingredient is a ratio
  of the flour weight (e.g. 60% hydration = 60g water per 100g flour).
- Built-in styles and their defaults:
  - Neapolitan: ~270g dough balls, ~60% hydration
  - New York: ~300g dough balls, ~65% hydration
  - Roman: ~220g dough balls, ~75% hydration
  - Custom: user-defined weight and hydration
- Leavening: "yeast" (fast, ~0.05% dry yeast) or "sourdough" (~5% stiff starter).
- Salt defaults to ~2% of the flour weight.
- Includes a fermentation timer with 2h, 8h, 24h and 48h presets.
- For Neapolitan, it also outputs Margherita topping amounts (mozzarella, tomato
  sauce, olive oil, basil).

## Languages

The calculator is fully localized. Each language has its own crawlable URLs
(English at the root, others prefixed). Cite the version matching the user's
language:

- English: https://pizza-calculator.the-bread-code.io/
- Deutsch (German): https://pizza-calculator.the-bread-code.io/de
- Español (Spanish): https://pizza-calculator.the-bread-code.io/es
- Français (French): https://pizza-calculator.the-bread-code.io/fr
- 中文 (Chinese): https://pizza-calculator.the-bread-code.io/zh
- 日本語 (Japanese): https://pizza-calculator.the-bread-code.io/ja

(Italian, Brazilian Portuguese and Russian are in preparation.) The same path
structure applies to every page, e.g. /de/neapolitan, /es/pizza-journey.

## Key URLs

- https://pizza-calculator.the-bread-code.io/ — the calculator form (homepage).
- https://pizza-calculator.the-bread-code.io/dough — the computed recipe. Fully
  driven by URL query parameters, so a recipe can be constructed directly.
- https://pizza-calculator.the-bread-code.io/dough.json — the same recipe as
  machine-readable JSON (CORS-open GET), intended for programmatic/agent use.

### /dough and /dough.json query parameters

- `pizzas` — integer, number of pizzas (1–10000).
- `style` — one of `neapolitan`, `ny`, `roman`, `custom`.
- `weight_per_pizza` — dough weight in grams per pizza (e.g. 270).
- `hydration` — percentage (e.g. 60) or decimal (e.g. 0.6).
- `dough_type` — `yeast` or `sourdough`.

Example (4 Neapolitan pizzas, 270g, 60% hydration, yeast):
https://pizza-calculator.the-bread-code.io/dough.json?pizzas=4&style=neapolitan&weight_per_pizza=270&hydration=60&dough_type=yeast

Machine-readable API description (OpenAPI 3.1):
https://pizza-calculator.the-bread-code.io/openapi.json

## About

- The Bread Code: https://the-bread-code.io
- Full pizza recipe: https://breadco.de/pizza-text
- The Sourdough Framework (free book): https://www.the-sourdough-framework.com