Why it matters
Opening an app just to check your progress is a small friction, but friction is exactly what breaks habits. When your breathwork metrics are buried inside an app you have to actively launch, they fade from your awareness between sessions — and what fades from awareness tends to fade from behavior. The BreathMAX Home Screen Widget keeps your two most motivating metrics visible without any interaction: your lung-health charge percentage and your current streak count, live on the face of your phone. The lung-health charge is a composite indicator that reflects the cumulative quality of your recent breath training — a single number between zero and one hundred that rises as you practice consistently and gradually decays during rest periods. The streak counter shows how many consecutive days you have completed at least one session. Together, these two numbers on your home screen create a persistent ambient reminder that your practice is a living, measurable thing — not an abstract intention. The widget updates in the background without requiring you to open BreathMAX, and it is designed for minimal battery impact on both iOS and Android. If you add only one feature from BreathMAX to your home screen workflow, this is the one that reliably drives daily return.
Inside the feature
The Home Screen Widget is available in a compact card format compatible with both iOS WidgetKit (iOS 14 and later) and Android App Widgets (Android 8 and later). It displays two values: the lung-health charge percentage with a radial fill indicator, and the current streak count with a flame icon. Both values update passively — the widget refreshes on a system-managed schedule without keeping the app active in memory, which is why the battery impact is low even on devices that enforce aggressive background process limits.
The lung-health charge metric is unique to BreathMAX. It is calculated from your recent session history — frequency, duration, and variety of breath patterns — and expressed as a single percentage. Think of it as a fuel gauge for your respiratory fitness: a hundred percent means you have been practicing consistently and recently, and the number starts to decline if you skip days. It is intentionally approximate rather than clinically precise, designed to nudge behavior rather than replace physiological measurement. That said, for users who have linked Apple Health or Health Connect, the underlying session data feeds into the same ecosystem that tracks HRV and other metrics.
The streak counter on the widget matches exactly what you see on the BreathMAX home screen — your current consecutive-day count. If you complete today's session, the number updates. If you miss a day and exhaust the grace window from the Streak System, the number resets. Having this live on your home screen creates a micro-accountability loop: every time you pick up your phone, you see whether your streak is intact. Behavioral research on habit formation consistently identifies this kind of low-friction environmental cue as one of the most reliable drivers of daily return.
The widget is compatible with the Dark Mode and Category Themes settings. On dark mode, the widget renders with a dark card and light text. On light mode, it flips to a light card. The widget does not require you to be signed in to display values — it reads from local device storage — but streak data syncs to your account when connectivity is available.
For users who want quick access beyond just viewing, tapping the widget opens BreathMAX directly to the home screen, one tap away from starting Today's Pick or any other session. This is the fastest possible path from noticing your metrics to acting on them.
The widget pairs naturally with Smart Reminders. A morning glance at a low lung-health charge, followed by a scheduled midday reminder notification, creates a two-touch nudge system that requires zero willpower to respond to — the environmental design does the motivating.
How to use it
On iOS, long-press an empty area of your home screen until the icons jiggle, then tap the plus icon in the top left corner. Search for BreathMAX in the widget gallery. Select the BreathMAX widget and choose the size — the compact size fits in a single grid cell and displays both the lung-health charge and streak count. Tap Add Widget, then drag it to your preferred position. On Android, long-press an empty area of your home screen, tap Widgets, and find BreathMAX in the list. Long-press the BreathMAX widget and drag it to your home screen. Both platforms update the widget automatically in the background. If values seem outdated, opening BreathMAX briefly triggers an immediate refresh. No account sign-in is required to display widget values, though streak sync across devices does require being signed in.
