Bean Freshness Alerts and Brew Rating Reminders

Beanstats uses local notifications for brew rating reminders and peak freshness alerts.

Peak Freshness Alerts

Enable Peak Freshness Alerts in Settings > Notifications to be notified when a bean reaches its estimated peak. Tap the notification to open the bean’s details.

The date follows your default brewing style, the bean’s roast level, and any roaster rest-day recommendation. It uses the same freezer-adjusted age as Brew Readiness.

  • Beans need a roast date and must not be archived or already at peak
  • No alert is scheduled while any portion remains frozen; thawing recalculates the date
  • Editing roast or rest dates, changing freeze entries or the default brewing style, and importing data refresh the schedule
  • Alerts normally arrive at 9 AM on the projected peak day. If that time has passed and peak is less than a day away, the alert is scheduled for the actual peak moment

Rating Reminders

When you log a brew without a rating, Beanstats can send you a notification later to remind you to rate it. After your first unrated brew, Beanstats offers to turn reminders on right there, so you do not have to find the setting first.

How It Works

  1. You log a new brew without a rating
  2. If rating reminders are enabled, a notification is scheduled
  3. After your chosen delay (default: 15 minutes), the notification appears
  4. Tapping the notification opens the rating sheet for that brew
  5. If you rate the brew before the notification fires, it’s automatically cancelled

Notification Content

Rating reminder notifications include:

  • Title: “How was your brew?”
  • Body: Contextual message mentioning the bean and method (e.g., “Your Ethiopian Yirgacheffe brewed with V60 is ready to rate!”)

Settings

Configure rating reminders in Settings > Notifications:

SettingDescriptionDefault
Rating RemindersEnable or disable reminder notificationsOff
Remind AfterHow long to wait after brewing15 minutes

Delay Options

Choose when to receive your reminder:

  • 15 minutes (default)
  • 30 minutes
  • 1 hour
  • 2 hours
  • 4 hours
  • 8 hours
  • Next day

The 15-minute default applies when you have not chosen a delay yet. A delay saved in an earlier version is kept.

Notification Actions

When a rating reminder appears, you have two options:

ActionDescription
Rate NowOpens the rating sheet for the brew
LaterDismisses the notification

Tapping the notification banner also opens the rating sheet.

Permissions

The app requires notification permissions to send rating reminders and peak freshness alerts. Permissions are requested when:

  • You enable rating reminders for the first time
  • You enable peak freshness alerts
  • You tap “Allow” in notification settings

If permission is denied, the toggle you were enabling turns back off and Beanstats offers a route to iOS Settings so you can allow notifications there.

Focus & Sleep Modes

Rating reminder notifications automatically respect your iOS Focus and Sleep settings. You won’t be disturbed during:

  • Sleep schedule
  • Active Focus modes that silence notifications
  • Do Not Disturb
Each brew can only have one rating reminder scheduled. If you edit a brew that already has a reminder scheduled, a new reminder won’t be created.