Skip to content

Getting Started

github-actions[bot] edited this page Aug 14, 2026 · 2 revisions

Getting Started

Install

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.

Welcome setup

The welcome flow appears once on a new installation and can be reopened from Settings → Experience → Welcome setup.

  1. Privacy overview: explains local storage, no account, and app-private photos.
  2. Appearance: choose System, Light, or Dark.
  3. Reflection: independently enable hunger, craving, and fullness scales; choose whether to show streaks.
  4. 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.

Record a meal

  1. Tap the camera button at the bottom of the app.
  2. Take a photograph. Ritual copies it from the temporary camera location into app-private storage and removes the temporary copy when Android permits.
  3. Select Breakfast, Lunch, Dinner, or Snack.
  4. Optionally choose any feelings, enabled reflection scales, a note, and a place.
  5. Tap Save.

The first manually saved entry on a calendar day can show a short streak overlay. Imported entries never trigger that overlay.

Edit or delete

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.

Clone this wiki locally