Home-screen widgets

Gauge's widgets put the numbers you check most on your iPhone home screen: calories left today, and your carb, fat, and protein progress. They update within moments of anything you log, and they follow the same training-aware targets as the app — a rest day and a race day read differently on your home screen too.

The three widgets

• Today's Calories (small) — your calories remaining over a tick-mark gauge, with a needle sitting at exactly where your day stands between zero and your goal. Go past your goal and the number flips to an honest "over" state.
• Today's Calories (medium) — the big remaining number with a progress bar, plus Food logged and your Goal for today. It also has a Log button — tapping it opens Gauge with the food input focused and the keyboard up, so you're typing immediately.
• Today's Macros (medium) — labeled bars for Carbs, Fat, and Protein, each showing grams so far against today's target — the same summary you read inside the app.

Tapping anywhere else on a widget opens Gauge to today.

Adding a widget

1. Press and hold an empty area of your home screen until the apps begin to jiggle.
2. Tap Edit in the top corner, then Add Widget.
3. Search for Gauge.
4. Swipe through the three designs, then tap Add Widget on the one you want.
5. Drag it where you like and tap Done.

You can add all three — they each earn their spot differently, and they update together.

How they stay current

The widgets refresh whenever you log, edit, or delete an entry in Gauge, and whenever your targets change — no setting to enable. At midnight they reset to zero eaten; your new day's targets load the next time you open the app, which for most people is breakfast.

If a widget looks wrong

• Shows "Open Gauge to sign in" — you're signed out. Open the app and sign in; the widgets repopulate on their own.
• Numbers look stale — open Gauge and let Home load once. The widgets mirror the app, so whatever Home shows is what they'll show.
• Widgets don't appear in the search — they need iOS 17 or later and Gauge 1.0.2 or later. Update either and check again; a restart of your iPhone nudges the widget gallery if it's being slow.
• Wrong color scheme — widgets follow your iPhone's system light/dark setting, which can differ from the theme you chose inside Gauge.

Android

Widgets are iPhone-only today. Android home-screen widgets are on the roadmap — the groundwork they share is already in place.