Troubleshooting
iOS SDK
Symptom
Likely cause
Fix
No data on dashboard
Tracker never started, wrong account ID, or trackView never called
Enable debugMode = YES; verify setupTrackerWithAccountId:domain: runs at launch and each view calls trackView:viewId:title:
Pings too frequent / infrequent (for your use case)
Default interval not tuned
Call setInterval: (seconds) before next trackView
CocoaPods: unable to find spec "Chartbeat"
CocoaPods cache stale
pod repo update then pod install
React Native SDK
Single warning react-native-chartbeat: Native module not available…
Running under Expo Go, or native module not autolinked
Use an Expo development build / bare RN / EAS Build; for bare RN, run pod install (iOS) and clean-rebuild Android
Gradle error: Could not find com.github.chartbeat:android_sdk
App-level Gradle overrides repositories and drops JitPack
Add maven { url '<https://jitpack.io'> } to root android/build.gradle (or settings.gradle)
iOS build error: No such module 'Chartbeat'
Pod not installed after package install
cd ios && pod install
No data in Chartbeat dashboard
setupTracker not called before trackView, or account/domain wrong
Verify setupTracker('<accountId>', '<domain>') runs at app start, and enable setDebugMode(true) to confirm pings are firing
Last updated
Was this helpful?