HealthKit Integration Guide

1. What Data Syncs

Gym Companion Coach integrates with Apple Health (HealthKit) to both read and write health data:

Data the app reads from Apple Health:

• Body weight — to track your weight over time and calculate nutrition targets
• Active energy burned — to show calories burned from other activities
• Heart rate — to display heart rate data during and after workouts
• Workouts — to show workouts recorded by other fitness apps

Data the app writes to Apple Health:

• Workouts — completed strength training sessions with duration and calories
• Dietary energy consumed — calories from meals you log in the app
• Body weight — weight entries you record in the app

HealthKit data is never used for advertising or shared with third parties. It is used solely to provide app functionality.

2. Granting Permissions

When you first open the app, you'll be asked to grant HealthKit permissions. You can choose which data types to share individually.

To review or change permissions later:

1. Open the Health app on your iPhone
2. Tap your profile picture in the top right
3. Tap Apps & Services
4. Find and tap Gym Companion Coach
5. Toggle individual data types on or off

The app works without HealthKit permissions, but some features (like heart rate tracking during workouts and automatic weight syncing) require access.

3. Viewing Data in Apple Health

Data written by Gym Companion Coach appears in Apple Health alongside data from other apps and devices:

• Workouts: Health app → Browse → Activity → Workouts
• Dietary calories: Health app → Browse → Nutrition → Dietary Energy
• Body weight: Health app → Browse → Body Measurements → Weight

Each entry shows "Gym Companion Coach" as the source, so you can easily identify which data came from the app.

4. Troubleshooting

Data from the app doesn't appear in Apple Health

• Check that write permissions are granted: Health app → Profile → Apps → Gym Companion Coach
• Make sure the specific data type (e.g., Workouts) has write access enabled
• Data is written after you complete and save a workout or meal — check that you finished the action

Weight from other apps isn't showing in Gym Companion Coach

• Verify that read permissions for Body Mass are enabled
• Check that the other app is writing to Apple Health (some apps require this to be enabled separately)
• Weight data may take a few moments to sync

Duplicate entries in Apple Health

• If you log a workout on both your iPhone and Apple Watch simultaneously, you may see duplicate entries
• Apple Health handles deduplication automatically for most data types
• To remove a specific entry: find it in Apple Health → tap it → scroll down → Delete