-
-
Notifications
You must be signed in to change notification settings - Fork 0
Getting Started
Download ritual-latest.apk from the repository's Ritual Latest GitHub release. Android may ask permission to install an app from the browser or file manager used to open it. Later APKs can update in place only when they are signed with the same key.
The welcome flow appears once on a new installation and can be reopened from Settings → Experience → Welcome setup.
- Privacy overview: explains local storage, no account, and app-private photos.
- Personal intention: choose Remember meals, Notice hunger and fullness, Understand feelings around food, Build a mindful pause, or Notice journal patterns.
- Appearance: choose System, Light, or Dark.
- Reflection: independently enable hunger, craving, and fullness scales; choose whether to show streaks.
- Rhythm: optionally request notification permission and choose breakfast, lunch, dinner, and empty-day check-in times.
Skip setup keeps the defaults: system theme; streaks on; reflection scales and reminders off. Every choice remains editable in Settings.
The top of the Journal presents one clear action based on the selected personal intention. Before the first entry it starts capture; after an entry is saved it becomes a compact count of today's recorded moments.
- Tap the camera button at the bottom of the app.
- Take a photograph. Ritual copies it from the temporary camera location into app-private storage and removes the temporary copy when Android permits.
- Select Breakfast, Lunch, Dinner, or Snack.
- Optionally choose any feelings, enabled reflection scales, a note, and a place.
- Tap Save.
The first manually saved entry on a calendar day can show a short streak overlay. Imported entries never trigger that overlay.
Open an entry from a daily journal or Browse result. The detail screen shows all recorded fields and offers edit/delete actions. Deleting an entry also deletes its private photo. Settings → Delete all journal data removes every entry, photo, saved calendar highlight, and best-streak record, while preserving settings.