Troubleshooting

Common issues and their solutions.

1. Connection Failed

If the app cannot connect to your website ("Network Error" or "Connection Failed"):

• Check URL: Ensure the URL in config.ts is correct and includes https://.

• SSL Certificate: Your site must have a valid SSL certificate (HTTPS) for iOS/Android to allow the connection.

• Permalinks: Go to Settings > Permalinks in WordPress and ensure "Post name" is selected. Click Save Changes twice to flush the rewrite rules. This is crucial for the REST API to work.

2. Images Not Loading

• Mixed Content: Ensure all your image URLs in the database are using https://. If you migrated from HTTP to HTTPS, you might need to use a "Better Search Replace" plugin to update old URLs.

3. License Activation Failed

• IonCube: Verify that the IonCube Loader is installed on your server.

• Internet Access: Your server must be able to make outgoing requests to verify the license.

4. Push Notifications Not Working

• OneSignal IDs: Double-check your App ID and API Key in the settings.

• Device Token: Run the app on a physical device. Simulators often do not support push notifications.

5. White Screen or Crash on Launch

• Metro Bundler: Ensure the Metro bundler is running (npm start) in a separate terminal window.

• Pod Install: If on iOS, did you run pod install in the ios folder after installing new packages?

6. iOS App Icon Not Visible or App Crashes on Launch (Permissions & Info.plist)

If your app opens with a white screen, crashes immediately, or iOS app icon does not appear correctly, this is usually caused by missing Info.plist permissions or configuration keys.

Make sure you have added the required permissions and settings to your ios/YourApp/Info.plist file.

Required Info.plist Entries

Add the following keys if they are missing:

<key>NSCameraUsageDescription</key>
<string>This app needs access to your camera to take photos for your profile picture.</string>

<key>NSPhotoLibraryAddUsageDescription</key>
<string>This app needs access to save photos to your photo library.</string>

<key>NSPhotoLibraryUsageDescription</key>
<string>This app needs access to your photo library to select images for your profile picture.</string>

<key>UIBackgroundModes</key>
<array>
	<string>remote-notification</string>
</array>

<key>RCTNewArchEnabled</key>
<true/>

<key>UIAppFonts</key>
<array>
	<string>AntDesign.ttf</string>
	<string>Entypo.ttf</string>
	<string>EvilIcons.ttf</string>
	<string>Feather.ttf</string>
	<string>FontAwesome.ttf</string>
	<string>FontAwesome5_Brands.ttf</string>
	<string>FontAwesome5_Regular.ttf</string>
	<string>FontAwesome5_Solid.ttf</string>
	<string>Foundation.ttf</string>
	<string>Ionicons.ttf</string>
	<string>MaterialIcons.ttf</string>
	<string>MaterialCommunityIcons.ttf</string>
	<string>SimpleLineIcons.ttf</string>
	<string>Octicons.ttf</string>
	<string>Zocial.ttf</string>
</array>

Need Help?

If you are still stuck, please open a support ticket with your purchase code.

For urgent support, you can contact me directly via the link. Süleyman Ekici