Getting Started
Welcome to Beanstats! This guide will help you get started with tracking your coffee journey.
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.
Info
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 Homescreen tap Log Brew, or go to the Brews section and tap + to log a brew. Choose between:
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 > 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 a sidebar navigation with the following sections:
| Section | Description |
|---|---|
| Home | Dashboard with summary and quick actions |
| Beans | Manage your coffee bean inventory |
| Brews | View and log brewing sessions |
| Equipment | Track your brewing equipment |
| Methods | Create brew method templates |
| Stats | View brewing statistics and insights |
| Settings | Configure app preferences |
On any of these pages you can press < to navigate back to the sidebar navigation.
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