BreathReminder (MVP)

Minimal mindfulness-of-breath reminders with dark, simple UI.

What it does:

• Schedules reminders at periodic and/or random intervals
• Vibrates briefly with configurable dot/dash pattern
• Shows a full-screen prompt over lock screen
• Record answers: Yes (mindful) / No
• Volume buttons: + = Yes, - = No
• Auto-dismiss in 60s and optionally escalate next interval
• Quiet hours by local time; reminders skip to morning
• Daily stats per day

Getting started:

1. Build and run on device (Android 9+, target 36). Grant vibration/notification permissions if requested.
2. In Home tab, tap "Start reminders" once; the app will schedule the next reminder and keep rescheduling.
3. Adjust Settings: mode, intervals, quiet hours, vibration pattern, escalation.
4. Check Stats tab for today's results; FAQ explains usage.

Notes on power:

• Uses AlarmManager.setExactAndAllowWhileIdle for a single next alarm. No foreground service. Keeps only one active reminder at a time.
• Quiet hours avoid wakeups during sleep window.

Known limitations in MVP:

• "Stop reminders" is a no-op; in next iteration we’ll cancel alarm and persist a flag.
• No persisted backlog; only next alarm is scheduled.
• UI is intentionally minimal.

Privacy: Data stays on-device via DataStore Preferences.

License: Personal use.