Getting Started
Welcome to Beanstats! This guide will help you get started with tracking your coffee journey.
First Launch
The first time you open Beanstats, a four-step setup walks you through the essentials:
- Welcome
- Brewing style and units, which set your defaults for new brews
- Your first bean
- A brew preview, where Start Brewing opens the brew form with your choices applied
Existing users skip setup automatically. Notification and Bluetooth permissions are requested when a feature needs them.
Home Screen
When you open Beanstats, you’ll be greeted with a personalized home screen that shows:
- Coffee inventory summary showing total grams of coffee remaining
- Time since last brew to track your coffee consumption
- Recent brews for quick reference
- Quick brew logging button to start logging immediately
Quick Start
1. Add Your First Coffee Bean
Navigate to the Beans section and tap the Add Bean button to add your first coffee. You can enter:
- Bean name and roaster
- Roast level and roast date
- Origin information (country, region, farmer, elevation)
- Weight per bag and number of bags
- Purchase price and notes
- Rating and photo
Only Bean name and weight are required.
If you tap and hold the Add Bean button you can add a bean by providing either a URL to a product page or by taking a picture of the coffee bag.
On devices with Apple Intelligence enabled the data is enriched and evaluated, giving you even more automatically detected fields.
2. Log Your First Brew
From the Home Screen tap Log Brew, or go to the Brews section and tap + to log a brew. Choose between:
- Home Brew for coffee you brewed yourself, with the full recipe
- Cafe Brew for coffee you drank out, with the cafe name and location
You can track dose, water weight, grind size, temperature, brew time and more. The app includes a built-in timer with bloom time tracking for pour-over methods.
3. Connect a Scale (Optional)
If you have a compatible Bluetooth coffee scale, navigate to Settings > Devices & Integrations > Scales to pair it. Once connected, you’ll get:
- Live weight readings during brewing
- Timer sync with your scale
- Real-time flow rate display
- Auto-start for both filter and espresso (configurable)
- Auto-capture when extraction completes (espresso)
See Scale Integration for supported scales and setup instructions.
Navigation
Beanstats uses five tabs. On iPhone they sit at the bottom of the screen, on iPad they appear in a floating bar at the top. Each tab keeps its navigation position when you switch between them.
| Tab | Description |
|---|---|
| Home | Dashboard with summary and quick actions |
| Beans | Manage your coffee bean inventory |
| Brews | View and log brewing sessions |
| Statistics | View brewing statistics and insights |
| More | Everything else, listed below |
The More tab contains:
| Section | Description |
|---|---|
| Cafes | Browse cafe visits and locations |
| Roasters | Browse the roasters behind your beans |
| Equipment | Track your brewing equipment |
| Methods | Create brew method templates |
| Water | Manage water profiles when enabled |
| Caffeine | View caffeine estimates when enabled |
| Settings | Configure app preferences |
Settings paths in these guides, such as Settings > Tracking, start from More > Settings.
Tips for Getting Started
- Start with your current beans - Add the coffee you’re currently drinking to begin tracking consumption
- Log brews consistently - The more data you log, the better insights you’ll get
- Use brew methods - Create templates for your regular brewing recipes to speed up logging
- Rate your brews - Ratings help identify your best recipes and preferences
- Connect a scale - If you have one, scale integration provides the best brewing experience