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 ios
2pod deintegrate
3pod install
4cd ..

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