> For the complete documentation index, see [llms.txt](https://docs.brewfather.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brewfather.app/beta.md).

# Public Beta

The current public beta version is **Brewfather 3.1.0**. The public beta lets you try selected features and improvements before they move to the stable release.

{% hint style="warning" %}
Beta software can contain bugs, incomplete behavior, or changes that are not yet reflected in the stable app. The beta uses your regular Brewfather account and data, so changes you make are live account changes. [Export a current backup](/data-safety.md#id-1-export-a-full-backup-web) before testing workflows that modify important data.
{% endhint %}

## Use the beta on the web

1. Open [beta.brewfather.app](https://beta.brewfather.app/).
2. Sign in with your regular Brewfather account.
3. Confirm the app version from **About** when reporting an issue.
4. To return to the stable web app, open [web.brewfather.app](https://web.brewfather.app/).

The web beta updates automatically. If a newly announced change does not appear, use **Settings → Application → Reload Application**.

## Join the iOS or Android beta

Mobile beta access and current installation instructions are coordinated through the Brewfather Discord community:

1. Join the [Brewfather Discord](https://discord.gg/WwBXhrUVeK).
2. Open the **#join-public-beta** channel.
3. Follow the current instructions in that channel for the iOS or Android beta.
4. Install the beta, sign in, and confirm the version from **About** before testing.

Use **#join-public-beta** for updated enrollment information because TestFlight and Google Play testing instructions can change.

After you join the public beta, the beta channels become visible. Follow **#public-beta-updates** for the most up-to-date changelog information.

## What is in version 3.1.0

### New features

* **Native Brew Tracker timer, Live Activities, and widgets** — Mobile timer state can continue through native notifications and widgets. Supported iPhones can show a Live Activity, while Android can show an ongoing timer notification. See [Brew Tracker](/batches/brew-tracker.md#native-timer-mobile-app).
* **Selectable Water Calculator pH engines** — Choose Water Engine 1, Water Engine 2, or Water Engine 3 (Advanced). Engine 3 adds Grain pH Profiles and per-malt assignments. See [Water Calculator](/recipes/water-calculator.md#ph-calculation-engine).
* **Expanded water adjustments** — Auto-calculate mash acid, choose from additional acids, use Potassium Carbonate, and dose liquid Calcium Chloride in grams or milliliters. See [Water Calculator](/recipes/water-calculator.md#acid).
* **Improved infusion and decoction planning** — Configure manual infusion amounts and temperatures, thick or thin decoctions, manual pull amounts, optional decoction rests, and decoction boil-off guidance. See [Mash Profiles](/profiles/mash.md#mash-step-types).
* **BeerJSON recipe import and export** — Exchange recipes using BeerJSON in addition to BeerXML and Brewfather JSON. See [Import Recipes](/getting-started/import-recipes.md#importing-from-other-software).
* **Inventory import and export** — Import or export Brewfather JSON, CSV, BeerXML, and BeerJSON inventory files. Exports can include the current filtered view or all inventory owned by your account. See [Inventory](/inventory.md#importing-and-exporting-inventory).
* **Juice and Honey fermentable types** — Classify these ingredients without treating them as a generic sugar, adjunct, or extract. See [Fermentables](/inventory/fermentables.md#fermentable-fields).
* **Trending community recipes** — Sort the public Library by recent community activity. See [Library](/library.md#sort-results).
* **Expanded API v2 write access** — Create, update, and delete recipes and inventory items, and delete batches with separate permission scopes. See [API](/api.md).
* **Profile data update requests** — Submit Equipment, Water, Mash, and Fermentation profiles for review in addition to ingredients. See [Add/Update data](/getting-started/add-update-data.md).

### Improvements and fixes

* Brew sheets, recipe output, and the Brew Tracker provide clearer infusion and decoction actions with more consistent unit formatting.
* Primary gravity and temperature series use colors that match their reading values in the fermentation chart. See [Fermenting](/batches/fermenting.md#fermentation-chart-colors).
* An attached iSpindel can use Plato or SG as its gravity input unit. See [iSpindel](/integrations/ispindel.md).
* Recipe history restore keeps a valid recipe folder when possible and otherwise restores the recipe to the default folder. See [Data Safety](/data-safety.md#id-3-restore-from-history).
* Inventory exports now let you explicitly choose the filtered inventory or all inventory owned by your account.
* Inventory purchase-cost calculations handle purchases made from zero or negative stock without carrying an invalid historical unit cost forward.
* Native timer, widget, iSpindel logging, and public Library reliability have received additional fixes.

## Find beta documentation

Pages that describe functionality still under public testing carry a **beta** tag. On pages that mix stable and beta behavior, a beta callout identifies the exact feature or improvement that is still being tested.

## Send feedback

Send beta feedback to <hello@brewfather.app> or through the [Brewfather Discord](https://discord.gg/WwBXhrUVeK):

* Use **#public-beta-chat** for beta discussion and questions.
* Use **#public-beta-feedback** to report beta feedback and issues.

These channels appear after you join the public beta through **#join-public-beta**.

When sending feedback, include:

* Brewfather version and build from **About**
* Web, iOS, or Android and the device/browser version
* Steps that reproduce the problem
* What you expected and what happened instead
* Screenshots or a short screen recording when useful

Do not post API keys, passwords, payment details, or private recipe/account data in a public Discord channel.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.brewfather.app/beta.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
