Google Fit

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 without using any terminal commands. Click + to add a new dependency and type `health` in the name field. Check pub.dev/packages/health for the current stable version and enter that exact version number (for example, `health: ^12.0.0`). Click Save. FlutterFlow will download and link the package in the background — you do not need to run `flutter pub get` manually. The `health` package is a unified cross-platform wrapper: it reads from HealthKit on iOS and from Health Connect on Android. By adding a single package, you enable health data access on both platforms. If you only need Android support, the same package still works — you will simply guard your action with `Platform.isAndroid` to prevent the iOS HealthKit code path from running. Once saved, the package is available to import in your Custom Actions.

In Custom Code, click + Add → Action and name it `getHealthConnectData`. This action requests Health Connect permissions and reads activity data for a given date range. Start by setting the return type to String and adding two DateTime arguments: `startDate` and `endDate`. In the Dart editor, import the required packages at the top: `import 'package:health/health.dart';`, `import 'dart:io' show Platform;`, and `import 'dart:convert';`. Inside the action body, add a platform guard at the top: `if (!Platform.isAndroid) return '[]';` — Health Connect is Android-only, and without this guard the action would throw on iOS or web. Create a `Health()` instance, call `health.configure(useHealthConnectIfAvailable: true)` to enable the Health Connect provider on Android. Define a list of health types you want to read — for example `[HealthDataType.STEPS, HealthDataType.HEART_RATE, HealthDataType.SLEEP_ASLEEP, HealthDataType.ACTIVE_ENERGY_BURNED]`. Call `await health.requestAuthorization(types)` — this triggers the Health Connect permission sheet on Android. Check the boolean result — if the user denied access, return `'[]'`. If authorized, call `await health.getHealthDataFromTypes(startDate: startDate, endDate: endDate, types: types)` to read the data. Convert the resulting `List<HealthDataPoint>` to a JSON-encodable list of maps and return `jsonEncode(result)`. Click Save in the Custom Code panel. In the Arguments configuration below the editor, verify that `startDate` and `endDate` are defined as DateTime parameters and the return type is String.

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

Health Connect requires explicit permission declarations in `AndroidManifest.xml` before the permission dialog will appear. Unlike iOS where permissions flow through the `health` package initialization, Android requires you to list each Health Connect permission as a `<uses-permission>` element. FlutterFlow cannot set these permissions from within its visual interface — you must edit the exported Android project. Export your FlutterFlow project (Basic plan or higher, or use GitHub integration) and open the project in Android Studio or any text editor. Navigate to `android/app/src/main/AndroidManifest.xml`. Inside the `<manifest>` element (before the `<application>` tag), add a `<uses-permission>` line for each health data type you read. For steps, heart rate, sleep, and active calories, add the corresponding Health Connect permission strings. Also add a `<queries>` element to declare that your app can query the Health Connect app. After editing, rebuild the project and install on your Android device. Note that you may need to re-add these entries after future FlutterFlow exports — document them in your project notes.

1<!-- Add to android/app/src/main/AndroidManifest.xml -->
2<!-- Inside <manifest>, before <application> -->
3<uses-permission android:name="android.permission.health.READ_STEPS" />
4<uses-permission android:name="android.permission.health.READ_HEART_RATE" />
5<uses-permission android:name="android.permission.health.READ_SLEEP" />
6<uses-permission android:name="android.permission.health.READ_ACTIVE_CALORIES_BURNED" />
7
8<!-- Also add inside <manifest> to declare Health Connect queries -->
9<queries>
10  <package android:name="com.google.android.apps.healthdata" />
11</queries>

In FlutterFlow, create an App State variable to store the health data. Go to App State in the left panel and click + Add State Variable — name it `healthDataJson`, type String, default value `'[]'`. Add a button to your page (for example, 'Sync Health Data') and open its Actions panel. In the Action Flow Editor, click + Add Action → Custom Action → getHealthConnectData. Map `startDate` to a DateTime value representing 7 days ago — create a Custom Function (Custom Code → + Add → Function) that returns `DateTime.now().subtract(const Duration(days: 7))` and use its output as the argument. Map `endDate` to a DateTime value for today (DateTime.now()). After the Custom Action completes, add an Update App State action to set `healthDataJson` to the action's return value (available under Action Outputs in the variable picker). Add a Text widget on the page bound to `healthDataJson` to verify data is flowing. For richer display, add FlutterFlow chart widgets and configure their data series from the parsed JSON values in App State. To show data immediately on page open, set the trigger to On Page Load rather than on a button tap. For a cross-platform build, also add the iOS HealthKit path using the HealthKit Custom Action (see healthkit page) on the same button, with a Conditional Action that checks `Platform.isIOS` first.

Health Connect Custom Actions will not work in FlutterFlow's web preview or Run mode — they will return empty data because `Platform.isAndroid` is false in a browser environment, which is the correct safe behavior. You must build and install on a real Android device. If you are using the exported project, open it in Android Studio and run directly on your connected Android device using the Run button. If you use the GitHub integration, clone the repo and run `flutter run` targeting your device. Before testing, ensure Health Connect is installed on the device: on Android 14+, it is built in under Settings → Health Connect. On Android 9-13, search for 'Health Connect' in the Play Store and install it. Add some test data to Health Connect — open the Health Connect app → Data and privacy → and either connect a fitness app or add test data manually. When your FlutterFlow app runs the Custom Action, it will show the Health Connect permission dialog listing the data types you requested. Tap Allow for each type. After granting permissions, the action reads data and returns it to App State. If Health Connect returns an empty list, confirm that the permission was granted in Health Connect app → App permissions → your app name.