Mobile App Errors
This page addresses common errors encountered in the Elite Quiz mobile application and provides solutions.
Authentication Issues
Unable to Login
Symptoms:
- Login process fails without error message
- "Authentication failed" error appears
- App freezes during login
Solutions:
- Verify Firebase configuration in the admin panel
- Check if the authentication method is enabled in Firebase
- Clear app cache and data
- Verify your Firebase project is properly set up for mobile authentication
- Check the device's internet connection
Social Login Failures
Symptoms:
- Google, Facebook, or other social login methods fail
- App crashes during social authentication
- Error messages from the social provider
Solutions:
- Verify OAuth configuration for the specific provider
- Check if the provider is properly enabled in Firebase
- Verify SHA-1 and SHA-256 keys are correctly added to Firebase
- Ensure the correct app ID and secret are configured
API Connection Issues
Cannot Connect to Server
Symptoms:
- Loading spinners that never resolve
- "Network error" or "Cannot connect to server" messages
- Quiz data doesn't load
Solutions:
- Verify API URL in the app configuration
- Check if the admin panel is online and accessible
- Verify internet connectivity on the device
- Check if your Firebase Realtime Database or Firestore is properly configured
Data Not Loading
Symptoms:
- Empty categories, quizzes, or leaderboards
- "Failed to fetch" errors
- Partial data loading
Solutions:
- Verify data exists in the admin panel
- Clear app cache
- Check if user has permissions to access the data
- Verify Firestore/Realtime Database rules allow proper access
UI and Rendering Issues
Display Problems
Symptoms:
- Misaligned elements
- Overlapping text or components
- Images not rendering properly
Solutions:
- Restart the app
- Update to the latest version
- Check if the device has adequate storage space
- Verify the device meets minimum system requirements
Performance Issues
Symptoms:
- App runs slowly
- Animations are choppy
- High battery consumption
Solutions:
- Close background apps
- Restart the device
- Update to the latest app version
- Check if the device meets recommended specifications
Quiz Functionality Issues
Timer Problems
Symptoms:
- Timer doesn't start or stops unexpectedly
- Timer counts down too quickly or slowly
- Timer resets unexpectedly
Solutions:
- Check device date and time settings
- Verify internet connectivity
- Restart the quiz
- Update to the latest app version
Answers Not Registering
Symptoms:
- Tapping on answers doesn't register
- Correct answers marked as incorrect
- Score not updating properly
Solutions:
- Check for screen protector or touch screen issues
- Restart the quiz
- Clear app cache
- Update to the latest version
In-App Purchase Issues
Purchases Not Completing
Symptoms:
- Purchase process starts but never completes
- Payment is processed but items not received
- "Item unavailable" errors
Solutions:
- Verify Google Play/App Store account is properly set up
- Check internet connectivity
- Verify the purchase item ID is correctly configured
- Contact support with purchase receipt
Restore Purchases Not Working
Symptoms:
- Previously purchased items not appearing
- "No purchases to restore" message
Solutions:
- Verify you're logged in with the same account used for original purchases
- Check if the purchase was made on a different platform
- Contact support with purchase receipts