HealthKit

In your FlutterFlow project, click Custom Code in the left navigation panel. At the top of the Custom Code screen, you will see a Pubspec Dependencies section — this is where you add pub.dev packages. Click the + button and type `health` in the package name field. Check pub.dev/packages/health for the current stable version (for example, `health: ^12.0.0`) and enter that version number. Click Save after adding the package. FlutterFlow automatically downloads and links the package into your project's dependency tree in the background — you do not need to run any terminal commands. Once saved, the `health` package will be available to import in any Custom Action or Custom Function you write. This single package covers both HealthKit on iOS and Health Connect on Android, so the same code supports both platforms when guarded with platform checks. If FlutterFlow shows a version conflict after adding the package, check whether other packages in your project depend on a different version of `health` and adjust the version pin to resolve it.

Still in Custom Code, click + Add → Action and name it `getHealthData`. This action will do two things: request authorization for the health types you want to read, and then read the data for a given date range. In the action's Dart editor, import the package with `import 'package:health/health.dart';` and `import 'dart:io' show Platform;` and `import 'dart:convert';`. Configure the action to accept two DateTime arguments named `startDate` and `endDate`, and set the return type to String (a JSON-encoded list of data points, since FlutterFlow Custom Action return types are limited). Inside the action body, start with a platform guard: `if (!Platform.isIOS) return '[]';` — this prevents crashes on Android or web where HealthKit is unavailable. Then create a `Health()` instance, call `health.configure()`, define a list of the HealthDataType values you want (for example STEPS, HEART_RATE, SLEEP_ASLEEP, ACTIVE_ENERGY_BURNED), and call `await health.requestAuthorization(types)`. Check the returned boolean — if false, the user denied access, so return `'[]'` rather than crashing. If authorized, call `await health.getHealthDataFromTypes(startDate: startDate, endDate: endDate, types: types)` and convert the resulting list of HealthDataPoint objects into a list of maps using the `.map()` method, then JSON-encode it with `jsonEncode()` and return the string. Click Save in the Custom Code panel after writing and verifying the action.

1// custom_action.dart — getHealthData
2import 'package:flutter/material.dart';
3import 'package:health/health.dart';
4import 'dart:io' show Platform;
5import 'dart:convert';
6
7Future<String> getHealthData(
8  DateTime startDate,
9  DateTime endDate,
10) async {
11  // HealthKit is iOS-only
12  if (!Platform.isIOS) return '[]';
13
14  final health = Health();
15  health.configure();
16
17  final types = [
18    HealthDataType.STEPS,
19    HealthDataType.HEART_RATE,
20    HealthDataType.SLEEP_ASLEEP,
21    HealthDataType.ACTIVE_ENERGY_BURNED,
22  ];
23
24  // Request native Apple permission dialog
25  final authorized = await health.requestAuthorization(types);
26  if (!authorized) return '[]';
27
28  // Read data for the given date range
29  final dataPoints = await health.getHealthDataFromTypes(
30    startDate: startDate,
31    endDate: endDate,
32    types: types,
33  );
34
35  // Convert to JSON-encodable list
36  final result = dataPoints.map((dp) => {
37    'type': dp.typeString,
38    'value': dp.value.toString(),
39    'unit': dp.unitString,
40    'dateFrom': dp.dateFrom.toIso8601String(),
41    'dateTo': dp.dateTo.toIso8601String(),
42  }).toList();
43
44  return jsonEncode(result);
45}

This is the step most tutorials skip and the one that causes App Store rejections. FlutterFlow cannot set the HealthKit entitlement or add Info.plist usage description strings from within its visual interface — these are native iOS project settings that require the exported Xcode project. Export your project from FlutterFlow using the Export Code option in the top menu (requires the Basic plan at $39/mo) or push to GitHub via Settings → Integrations → GitHub and clone the repo. Open the `.xcworkspace` file in Xcode on a Mac. In Xcode, select your app target in the Project Navigator, then click the Signing & Capabilities tab. Click the + Capability button, search for HealthKit, and double-click to add it. This writes the HealthKit entitlement into your app's `.entitlements` file. Next, open `Info.plist` in Xcode (or in your code editor) and add the key `NSHealthShareUsageDescription` with a string value explaining in plain language why your app needs to read health data — for example: 'This app reads your step count, heart rate, and sleep to show your daily fitness summary.' If your app writes health data (saves workouts, etc.), also add `NSHealthUpdateUsageDescription` with an explanation. These strings appear verbatim in the iOS permission dialog that users see, so write them in clear, friendly language. Without NSHealthShareUsageDescription, HealthKit will crash when it tries to show the permission dialog and your app will be rejected from the App Store during review. After making these changes, build and run on your iPhone from Xcode to verify that the permission dialog appears with your usage strings.

1<!-- Add inside the <dict> tag in ios/Runner/Info.plist -->
2<key>NSHealthShareUsageDescription</key>
3<string>This app reads your step count, heart rate, and sleep data to show your daily fitness summary.</string>
4<key>NSHealthUpdateUsageDescription</key>
5<string>This app saves your workout sessions to Apple Health so you can track your fitness history.</string>

Back in FlutterFlow, create an App State variable to hold the health data. Open App State from the left panel and click + Add State Variable. Name it `healthDataJson`, set the type to String, and give it a default value of `'[]'`. Now place a button on your page (for example, labeled 'Sync Health Data') and open its Actions panel. In the Action Flow Editor, click + Add Action → Custom Action → getHealthData. Map the `startDate` argument: click the argument field, select From Variable, and use a DateTime value representing 7 days ago. You can compute this using a Custom Function that returns `DateTime.now().subtract(Duration(days: 7))` — create that function in Custom Code → Function first. Map `endDate` to Now (DateTime.now()). After the Custom Action, add a second action: Update App State → set `healthDataJson` to the return value of the Custom Action (available under Action Outputs in the variable picker). Add a Text widget bound to `healthDataJson` App State to confirm data is flowing. For a richer display, add a chart widget and configure it with parsed step values. Consider triggering this action On Page Load (in the page's Action Flow) so users see their stats as soon as the page opens, rather than having to tap a button every time. For date range selection, add a DateRangePicker widget and pass those DateTime values as arguments to the Custom Action instead of hardcoded dates.

HealthKit Custom Actions will not work in FlutterFlow's Run mode or any browser-based preview. When you tap your button in Run mode, the `Platform.isIOS` guard returns false (because the code is running in a web browser context) and the action returns an empty array — this is safe, intentional behavior, not a bug. To test the real HealthKit integration, you must build and install on a physical iPhone. Use option A: export your project from FlutterFlow and build from Xcode on a Mac with your paid Apple Developer account. Or use option B: push to GitHub via FlutterFlow's GitHub integration, clone the repo on a Mac, and run `flutter run` targeting your connected iPhone. Before testing, add some health data to the iPhone's Health app manually — go to Health app → Browse → Activity → Steps → Add Data — so the permission dialog has something to authorize and the data read has entries to return. On first launch, the native Apple health permission sheet will appear listing each health data type your action requests — tap Allow All. If you see no data returned after granting permission, check that the date range you passed covers days that have health data recorded. If you see MissingPluginException in the Xcode console even on a real device, clean the Xcode build folder (Product → Clean Build Folder) and rebuild.