-
-
Notifications
You must be signed in to change notification settings - Fork 0
Reminders and Streaks
Defaults are Breakfast 9:30 AM, Lunch 1:30 PM, Dinner 7:30 PM, and Empty-day check-in 9:30 PM. Each time can be changed in Settings or the welcome flow. Times use the device's local time zone and display in the Android locale's 12- or 24-hour format.
After at least five distinct recent days for a meal type, Ritual can compare the user's chosen reminder with the median time that meal is logged. If the difference is meaningful, Ritual offers to move the reminder to five minutes before the usual logging time. The user must explicitly choose Move or Keep. Ritual never changes a chosen time silently, and a kept suggestion is not shown again unless the observed pattern changes.
Meal notifications provide four direct actions:
- Take a photo: opens the camera and then the matching meal editor.
- Remind me in 30 minutes: schedules one local snooze without replacing the regular reminder time.
- Skip today: pauses all remaining meal reminders for the current local date.
Take a photo and tapping the notification body both open the camera for the matching meal. If app lock is enabled, Ritual waits for the user to unlock before opening journal content.
Ritual schedules a rolling 14-day window of local notifications and refreshes it when journal entries change, reminder settings change, or the app resumes.
For each day:
- A breakfast reminder is omitted if Breakfast is already logged for that date.
- Lunch and dinner follow the same meal-type rule.
- Snack entries do not suppress meal-type reminders.
- The empty-day check-in is scheduled only when the date has no entries of any type.
- A reminder whose configured time has already passed is not scheduled.
- Disabling reminders cancels Ritual's pending meal-reminder notifications.
- Choosing Skip today suppresses the current date without affecting future dates.
Notifications use an Android channel named Meal reminders, default importance, and inexact idle scheduling. Android may batch or delay them to save battery. Ritual never sends reminder data to a server.
Reminder wording follows the personal intention selected in onboarding or Settings.
On supported Android versions, enabling reminders first checks whether notifications are already allowed. If not, Ritual invokes the Android permission prompt. A denial leaves the toggle off and offers a path to app notification settings. Permission and the Ritual toggle are separate: both must be enabled.
A streak counts distinct local calendar dates with at least one entry; multiple meals on one day count once. The current streak remains active when the latest logged day is today or yesterday, which lets the user begin the current day without losing yesterday's streak. A gap of two or more days resets current progress. Best progress is retained separately.
The journal header shows Monday through Sunday. Completed days have a check; today has a highlighted ring; future days are muted. Current and best counts remain above the weekday row.
The short overlay appears only after the first entry manually added on a calendar day, automatically closes after a few seconds, and includes a skip button. Special copy is used at 7, 30, 100, and 365 days. Day 1 has first-streak copy; other days use the standard count. Imports never trigger the overlay. Disabling Daily streaks hides the card and celebrations without deleting progress.