Troubleshooting
Common issues and how to resolve them.
CocoaPods Issues (iOS)
If you encounter errors related to native modules on iOS, it's often a CocoaPods sync issue.
1cd ios2pod deintegrate3pod install4cd ..
Clear Metro Bundler Cache
Weird JavaScript errors or stale changes? Clearing the packager cache usually fixes it.
1npx expo start -c
Environment Variables Not Loading
Remember that .env variables are loaded at build time. If you change them, you need to restart the development server.
1EXPO_PUBLIC_ prefix is required for client-side variables.
Still Stuck?
If you can't find the solution here, check the official documentation or open an issue on GitHub.
Last updated on 2/10/2026
Edit this page on GitHub