Question 1

How do I set up react-native-fitness with Google Fit API key?

Accepted Answer

You need to get an OAuth 2.0 Client ID from Google Fit as explained in the README, then add it to your Android project by configuring the build.gradle files and ensuring proper dependencies. The library requires this for Android data access, but no similar setup is needed for iOS beyond HealthKit capabilities.

Question 2

react-native-fitness vs react-native-health: which should I use?

Accepted Answer

react-native-fitness offers a simpler, unified API for core fitness data across iOS and Android, while react-native-health might provide more features but with different abstractions. Choose react-native-fitness for basic cross-platform consistency, but compare based on required data types and platform support.

Question 3

Does react-native-fitness work with Expo?

Accepted Answer

It likely requires ejecting from Expo or using a custom development build, as it involves native modules for HealthKit and Google Fit. Expo's managed workflow doesn't support such native integrations without configuration changes.

Question 4

How to handle errors in react-native-fitness?

Accepted Answer

The library provides an Errors attribute with platform-specific error codes, such as hkNotAvailable for iOS or methodNotAvailable for Android. Catch promises in API calls and check these errors for troubleshooting, but documentation on resolution is limited.

Question 5

What permissions are needed for sleep analysis on iOS?

Accepted Answer

You need to request SleepAnalysis permission using PermissionKinds.SleepAnalysis with read access in isAuthorized or requestPermissions. Ensure NSHealthShareUsageDescription is set in Info.plist, as specified in the iOS setup instructions.

Question 6

Can I use react-native-fitness for background data fetching?

Accepted Answer

The library supports data fetching over intervals but doesn't explicitly mention background modes. You may need to implement native background tasks separately, as it primarily focuses on API calls for historical data, with real-time updates only for steps on Android.

Question 7

Is react-native-fitness actively maintained?

Accepted Answer

It's open-source and maintained by the community with PRs encouraged, but the README shows last updates might be infrequent. Check GitHub for recent activity and issue resolution before relying on it for production apps.

react-native-fitness

What is react-native-fitness?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions