Coffee Widgets for Home Screen and Lock Screen
Beanstats ships seven widgets for your Home Screen and Lock Screen, so your inventory, bean freshness, and a shortcut into the brew form are one glance away.
Available Widgets
| Widget | Sizes | Shows |
|---|---|---|
| Coffee Inventory | Small, Medium, Lock Screen | Coffee remaining, active bag count, top-rated beans |
| Bean Freshness | Small, Lock Screen | A selected bean’s freshness phase, age, and remaining weight |
| Last Brew | Small, Lock Screen | Time since your last brew, bean, rating, dose |
| Quick Log | Small, Lock Screen (circular) | Buttons that jump straight into the brew form |
| Freeze Stats | Small, Lock Screen | Frozen weight, entry count, oldest freeze |
| Caffeine | Small, Medium, Lock Screen | Caffeine in your system, today’s total against your limit |
| Brew Activity | Medium | A 26-week heatmap of your brewing |
Widgets listed with Lock Screen support have circular, rectangular, and inline formats, except Quick Log, which is circular only. Brew Activity is Home Screen only.
Coffee Inventory
Your stash at a glance: total bean weight and how many active bags you have.
The medium size adds a “Best Beans” panel with your three highest-rated active beans, each with name, roaster, and star rating. A quick reminder of what to brew next.
Tap the widget to open your bean list.
Bean Freshness
Shows a bean’s freshness phase, readiness line, day count, and remaining weight. Long-press the widget and edit its configuration to choose an active bean. Leave the selection empty to follow the freshest active bean automatically.
The widget uses the same freshness windows and freezer-adjusted clock as Brew Readiness. While any of the bean remains frozen, its day count stays paused. A pinned bean that is archived or removed shows Bean no longer active rather than switching to a different coffee.
Tap the widget to start a new brew with that bean selected.
Last Brew
The bean you last brewed, your rating (to the half star), the dose you used, and how long ago it was. The large relative time updates live; compact Lock Screen text refreshes hourly. Tap to open that brew’s details.
Quick Log
Two buttons, Espresso and Filter, that open Beanstats with the matching brew form already set up. On the Lock Screen it becomes a single circular button.
Freeze Stats
For anyone who freezes beans: total frozen weight in your selected units, how many freeze entries are active, and your oldest freeze with its tag and age, such as “ABC12 (14 days)”. Tap to open the bean list. All sizes show a disabled state when freeze tracking is turned off.
Caffeine
Available when caffeine tracking is enabled. Shows the caffeine still in your system, today’s total against your daily limit, and the projected level at bedtime. The medium size puts today’s total on a circular gauge that turns red once you pass your limit.
Tap to open the caffeine dashboard. All sizes show a disabled state when tracking is off.
Brew Activity
A heatmap of the past 26 weeks, one cell per day, shaded across five levels by how many brews you logged. The footer shows your total for the period.
Tap to open Statistics.
Adding Widgets
Home Screen
- Long-press on your Home Screen
- Tap the + button in the top corner
- Search for Beanstats
- Choose a widget and size, then tap Add Widget
Lock Screen
- Long-press on your Lock Screen
- Tap Customize
- Add Beanstats widgets to the area above or below the clock
How Widgets Stay Current
Widget data refreshes when you leave the app, with targeted updates after actions such as saving or rating a brew. Inventory, freeze stats, and Last Brew request hourly refreshes. Caffeine has 15-minute decay updates between two-hour reloads, and Brew Activity refreshes at midnight. Bean Freshness schedules updates for day-count and phase changes. iOS controls when widget refreshes are delivered.
Related
- Home Screen - The same data inside the app
- Siri Shortcuts - Voice commands and automations
- URL Schemes - Deep links into the app