Support

Connect Apple Health

Breakfast reads running workouts already saved in Apple Health. Record your runs with your watch or another app that saves running workouts to Health.

1. During setup, tap Connect Apple Health and allow read access to workouts, workout routes, and the measurements you want to see.
2. To review access later, open Health, tap your profile, then find Breakfast under Apps.
3. In Breakfast, open Settings → Apple Health and tap Reconnect Apple Health. This requests any new permissions and checks your history for missing runs.

Breakfast only reads your Health data. Apple keeps your read-permission choices private, so check them in Health even if Breakfast reports that a check has finished.

A run is missing

1. Check that the workout appears in Apple Health on this device and is recorded as a running workout. If it is missing there, let your watch or recording app finish syncing first.
2. Review Breakfast’s Health access using the steps above.
3. Open Settings → Run data (called Run setup in 1.0.0) and tap Sync now. Check Progress for activity or an error.
4. In Runs, clear any search text and filters that might hide the workout.

If older runs are missing, try Reconnect Apple Health from the Apple Health settings page to check your full history.

Import progress and incomplete routes

Your run list arrives first. Maps, elevation, running metrics, and personal bests can take longer. Checking these extra details is sometimes called enrichment.

You can choose Explore while importing during setup. Today shows progress for the initial import and analysis. If it pauses, tap Open run data, or go to Settings → Run data. Use Sync now for the run list and Check run details for maps and metrics. Keeping Breakfast open helps a large check finish.

A watch can send a workout before its route has finished syncing. Give it time, then use Check run details again. View route details shows runs with missing or unfinished route data and the result of the last check.

Indoor runs usually have no GPS route. Some recording apps also save a workout without its route or detailed measurements. Breakfast can only show the data Apple Health shares. A completed check can still include unavailable routes.

Personal bests

Open Settings → Run data → Find personal bests. Choose Check all runs for your full history or Check the last 90 days for a quicker first check. If available, See runs still to check explains outstanding checks.

Breakfast needs usable route points and timestamps covering the full distance to calculate a personal best. A short run, missing GPS data, an incomplete route, or rejected GPS errors can leave it without a qualifying effort. A workout that Health cannot return cannot be checked. Finishing analysis does not guarantee a personal best.

For treadmill runs, review Settings → Training → Include treadmill runs. Enabling it still requires usable recorded data. If a distance is missing from your results, also check Hidden distances on the Training page.

What iCloud syncs

Turn on iCloud sync in Breakfast’s Settings on each device, using the same Apple Account. It syncs shoes, tags, goals and their completion history, notes, favourites, and shoe and tag assignments through your private iCloud database.

Health measurements, routes, personal-best results, and calculated goal progress remain local. Each device needs its own Health access and imported workouts. Seeing your shoes on another device does not mean its runs have finished importing.

Check the status beneath the switch. If it is waiting for iCloud, check your connection and Apple Account, then give it time. Turning sync off stops future updates. It does not erase copies already in iCloud.

Widgets

Add Breakfast from your Home Screen’s widget gallery. The choices are Last run, Run streak, Weekly mileage, Goal progress, and the small Club poster.

If a data widget is empty or out of date, open Breakfast on that device and check that the run import has finished. Goal progress also needs an active goal. Widgets read the local library, and updates may take a little time to appear.

Send a PB pacer to Apple Watch

On the Personal bests screen, choose Race it for a record. Adjust Target and Day, then tap Send to Watch. Allow workout scheduling when asked. The pacer appears in the Workout app on your compatible paired Apple Watch.

If scheduling fails, check your Watch connection and try again. If permission was declined, allow Breakfast under Workouts in your device’s privacy settings, then retry.

Siri and Shortcuts

In Shortcuts, search for Breakfast when adding an action. You can use Open latest run, Get latest run summary, Get running distance, and Open goals. The distance action lets you choose This week or This month.

Finish setup and importing in Breakfast first. These actions use the saved library and require device authentication. If a result is missing or old, unlock your device, open Breakfast, and check the import before trying again.

The summary and distance can pass to later actions in your shortcut. Siri may use Apple’s cloud services. See the privacy policy for the data shared.

Re-processing and resetting

Both options are in Settings → Run data. Try the individual sync, run-detail, or personal-best checks first.

Re-process everything

This clears calculated metrics and personal bests, then rebuilds them using available Health data. It preserves your imported workouts, shoes, tags, notes, favourites, goals, and assignments. Route names refill as you browse. A large history can take several minutes.

Reset and reimport

This permanently erases Breakfast’s library on this device and in iCloud. It removes imported runs, shoes, tags, notes, favourites, goals, plans, training preferences, and analysis. Only workouts still available from Apple Health can be reimported. Your annotations and other library items cannot be recovered by that import. Apple Health’s own data is kept.

The Reset and reimport… button checks Health and iCloud, then shows the number of available runs before the final confirmation. Check that count carefully. Cancel if it is unexpected or you want to keep your library details. Contact support if you are unsure.

What’s the business model?

Breakfast is still in its early days. We have plans for some powerful additions in future, and some of those could become paid features. We haven’t settled on a business model or pricing yet.

Contact support

Email [email protected]. For a problem report, please include your app version from Settings → About Breakfast, your iOS or iPadOS version, your device model, and the steps that reproduce the problem. Tell us what you expected and what happened.

A redacted screenshot is optional. Please hide personal information, exact locations, and routes. A description is enough to start with, so please keep private Health exports and precise route files out of your email.