HealthBase

Support & Help

What's in HealthBase

🏃
Workouts

Browse every workout from Apple Health and Strava in one unified list. Filter by activity type, date, location, cadence, or source. Tap any workout for GPS maps, heart rate graphs, elevation profiles, speed charts, and more.

📊
Stats

See your daily step count and workout duration for the past 7 days, plotted against your personal step goal.

🥗
Nutrition

Log food for the day with calorie and macro tracking. Search by name or scan a barcode to look up nutritional info automatically.

🔗
Strava Integration

Connect your Strava account to pull in activity names, Relative Effort scores, gear info, and precise time zones. Export Apple Health workouts to Strava directly from the app.

📤
Excel Export

Export your full workout history to an Excel (.xlsx) file from Settings. Share it anywhere via the iOS share sheet.

Connecting Strava

HealthBase uses your own Strava API credentials, which keeps your data private and within your control. Setup takes about 5 minutes.

1
Create a Strava API Application

Go to strava.com/settings/api and create a new application. Set the Authorization Callback Domain to localhost.

2
Copy your credentials

After creating the app, Strava shows you a Client ID (a number) and a Client Secret (a long string). You'll need both.

3
Enter them in HealthBase

Open Settings → Strava Integration, paste your Client ID and Client Secret, then tap Connect with Strava and authorize the app.

4
Reload your workouts

Pull to refresh on the Workouts screen. HealthBase will match Apple Health workouts to Strava activities and merge their data.

Frequently Asked Questions

Why isn't a workout showing up?

HealthBase reads workouts from Apple Health. Make sure the app has Health permissions: go to iPhone Settings → Health → Data Access & Devices → HealthBase and confirm that workout access is enabled.

Workouts default to showing the last 30 days. Check whether a date filter is active — tap the filter icon at the top left of the Workouts screen to review or clear filters.

If you just recorded a workout, pull to refresh on the Workouts screen.

Why does a workout show no location or map?

GPS route data comes from Apple Health. If the workout was recorded without GPS (for example, on a treadmill, or if location was disabled during recording), no route will be available.

Location labels in the workout list are geocoded from GPS coordinates and cached locally. While the cache is building you'll see a progress indicator at the top of the list — locations will fill in as geocoding completes.

Why isn't my Strava workout matching an Apple Health workout?

HealthBase matches workouts by comparing their start times. The default tolerance is 60 seconds. If your watch and phone clocks differ, or if Strava and Apple Health recorded slightly different start times, you may need to increase the tolerance.

Go to Settings → Strava Integration → Match Tolerance and raise the value. Then pull to refresh on the Workouts screen.

How does Activity Type Mapping work?

When you export a workout to Strava, HealthBase maps the Apple Health activity type to the closest Strava sport type. If the default mapping isn't right for you — for example, if you want indoor cycling workouts to appear in Strava as Virtual Ride — you can override it.

Go to Settings → Strava Export Defaults → Activity Type Mapping, tap +, choose the source type, and pick the Strava type you want it exported as.

What does "Clear Workout Cache" do?

Clear Workout Cache removes the locally cached workout list so it will be re-fetched fresh from Apple Health and Strava on the next load. Your geocoded location data is preserved.

Clear Workout Location Cache additionally removes all cached geocoded locations. After clearing, HealthBase will re-geocode each workout the next time it loads — this can take a while if you have many workouts.

Use these options if workouts are missing or out of date and a pull-to-refresh doesn't help.

How do I export my workouts to Excel?

Go to Settings → Data Export → Export Workouts. HealthBase generates an .xlsx file containing all cached workouts and presents the iOS share sheet so you can save it to Files, email it, or send it to another app.

Tip: elevation and speed data populate as you open individual workouts. Open any workouts you want those columns filled in for before exporting.

What data does HealthBase access?

HealthBase reads workout data, route GPS data, heart rate samples, and step counts from Apple Health — only the data types you authorize. No data is sent to any server. All processing happens on your device.

If you connect Strava, HealthBase communicates directly with the Strava API using your own credentials. No third-party servers are involved.

Food entries are stored locally on your device using SwiftData and are not shared or backed up outside of iCloud (if you have iCloud backups enabled).

Why does the app show "Unable to Load" on the Workouts screen?

This usually means HealthBase was denied access to Apple Health. Go to iPhone Settings → Health → Data Access & Devices → HealthBase and enable the relevant data types, then return to the app and tap Retry.

If Strava is connected and a Strava error appears in Settings, tap the copy icon next to the error and send it to support so we can help diagnose the issue.

Contact Support

Have a question not answered here, or found a bug? Send an email and we'll get back to you as soon as possible.

Email Support