Docs / HealthKit Sync
HEALTHKIT SYNC
How your Apple Health data powers your character
Last Updated: February 2026
How Does HealthKit Sync Work?
Fitscape reads your workout data from Apple HealthKit — the centralized health data platform built into iOS. When you complete a workout using Apple Watch, iPhone, or any HealthKit-compatible app, that workout is stored in Apple Health. Fitscape then reads that data, identifies the activity type, and converts it into XP for the appropriate character stat.
This means Fitscape works with any Apple Watch app, Garmin, Strava, Nike Run Club, Peloton, MyFitnessPal, or any other app that writes to Apple Health. You do not need to use a specific tracker — any HealthKit-compatible source works.
What Data Does Fitscape Read?
| Data Type | Used For | Required? |
|---|---|---|
| Workout Sessions | Activity type identification, XP calculation | Yes |
| Active Energy Burned | XP intensity scaling | Recommended |
| Workout Duration | Base XP calculation | Yes |
| Distance (Walking/Running/Cycling) | Dungeon progress tracking | Recommended |
| Step Count | Supplemental movement tracking | Optional |
| Mindfulness Minutes | Wisdom XP from meditation | Optional |
How Is XP Calculated from Health Data?
XP calculation uses two primary signals from HealthKit: activity type (to determine which stat receives the XP) and duration + intensity (to determine how much XP is awarded).
Step 1: Activity Type Mapping
Fitscape reads the HealthKit workout type and maps it to one of the six stats. For example, .traditionalStrengthTraining maps to STR, while .running maps to DEX.
Step 2: XP Amount Calculation
Base XP scales with workout duration. When active calorie data is available, intensity modifies the XP — harder workouts earn proportionally more XP for the same time investment.
Workout Stat Mapping Summary
| Stat | Example HealthKit Types |
|---|---|
| STR | traditionalStrengthTraining, highIntensityIntervalTraining, functionalStrengthTraining |
| DEX | running, cycling, soccer, basketball, tennis, martialArts |
| CON | hiking, swimming, walking, elliptical, rowing, stairClimbing |
| INT | yoga, pilates, barre, flexibility, mindfulCooldown |
| WIS | mindAndBody (meditation, tai chi, mindfulness), breathwork |
| CHA | groupFitness, dance, teamSports, socialWorkouts |
How Does HealthKit Affect Stamina Restoration?
Stamina is the resource your character uses to explore dungeons. Unlike Health (which regenerates slowly) and Mana (which is restored through mindfulness activities), Stamina is restored overnight — and the amount restored is tied to your readiness score.
Your readiness score is derived from HealthKit data about your recent physical output and recovery. Days when you exercise heavily and rest well result in higher readiness the next morning, restoring more Stamina. This mechanic rewards balanced training and discourages overtraining.
Note on Stamina
Stamina does not regenerate automatically throughout the day. It is fully evaluated once per night. Start each day with your readiness-adjusted Stamina pool.
Privacy and Data Security
Your health data belongs to you. Fitscape only reads the specific HealthKit categories you explicitly authorize. The data is used solely to calculate game mechanics — it is never sold, shared with third parties, or used for advertising.
| Data Practice | Fitscape Policy |
|---|---|
| Data selling | Never sold |
| Third-party sharing | Not shared except as required by law |
| Advertising targeting | Health data not used for ads |
| Permission revocation | Revoke at any time via iOS Settings |
For complete details, see the Privacy Policy.
Troubleshooting Sync Issues
Workouts not syncing?
Open iOS Settings > Privacy & Security > Health > Fitscape and confirm all requested permissions are enabled. Then reopen Fitscape and trigger a manual sync.
XP not reflecting recent workout?
Allow a few minutes for HealthKit to finish processing after your workout. If the workout was logged by a third-party app, ensure that app has permission to write to Apple Health.
Wrong stat being leveled up?
Check the workout type recorded in Apple Health. If the activity was logged as a generic "Workout" rather than a specific type (e.g., Running), Fitscape may not be able to determine the correct stat mapping.