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