🔧 Troubleshooting Guide

❌ App Won't Install

Problem: The app fails to install or shows an error message.

Solutions:

• Check your device storage (need at least 100MB free)
• Ensure you have a stable internet connection
• Try restarting your device
• Clear app store cache and try again
• Check if your device meets minimum requirements

🔄 App Won't Update

Problem: The app shows an update is available but won't update.

Solutions:

• Force close the app and try again
• Check your internet connection
• Restart your device
• Try updating from the app store directly
• Clear app data and cache

🚫 Can't Log In

Problem: Unable to access your account or login fails.

Solutions:

• Verify your email and password are correct
• Check if caps lock is enabled
• Try the "Forgot Password" option
• Ensure your account isn't suspended
• Check your internet connection

✅ Verification Not Working

Problem: Account verification process is stuck or failing.

Solutions:

• Check your email spam folder
• Ensure your email address is correct
• Try requesting a new verification email
• Contact support if the issue persists
• Check if your email provider is blocking our emails

📧 Email Not Received

Problem: Not receiving emails from Sports Buddies.

Solutions:

• Add noreply@joinsportsbuddies.app to your contacts
• Check spam and junk folders
• Verify your email address is correct
• Check your email provider's filtering settings
• Try using a different email address

🔍 No Matches Found

Problem: The app isn't finding any potential matches.

Solutions:

• Expand your search radius
• Check if your location services are enabled
• Update your sports preferences
• Ensure your profile is complete
• Try adjusting your skill level preferences

📍 Location Issues

Problem: App can't determine your location or shows wrong location.

Solutions:

• Enable location services for the app
• Check your device's location permissions
• Try refreshing your location
• Ensure GPS is enabled
• Check if you're in a supported region

📤 Can't Send Messages

Problem: Unable to send messages to other users.

Solutions:

• Check your internet connection
• Ensure you're connected to the user
• Check if your account is verified
• Try restarting the app
• Contact support if the issue persists

📥 Not Receiving Messages

Problem: Not getting notifications or messages from other users.

Solutions:

• Check notification settings
• Ensure the app has notification permissions
• Check if Do Not Disturb is enabled
• Try refreshing the app
• Check your internet connection

🔕 No Push Notifications

Problem: Not receiving push notifications from the app.

Solutions:

• Check app notification permissions
• Enable notifications in device settings
• Check notification preferences in the app
• Ensure the app isn't battery optimized
• Try reinstalling the app

📱 Too Many Notifications

Problem: Receiving too many or unwanted notifications.

Solutions:

• Adjust notification preferences in app settings
• Customize which types of notifications you receive
• Set quiet hours for notifications
• Mute specific conversations if needed
• Contact support for advanced notification controls

🐌 App is Slow

Problem: The app is running slowly or lagging.

Solutions:

• Check your internet connection speed
• Close other apps running in background
• Clear app cache and data
• Restart your device
• Check if your device has enough storage

💥 App Crashes

Problem: The app keeps crashing or closing unexpectedly.

Solutions:

• Update to the latest app version
• Clear app cache and data
• Check if your device has enough storage
• Try restarting your device
• Reinstall the app if the problem persists

📶 Network Connection Issues

Problem: App shows network errors or can't connect.

Solutions:

• Check your Wi-Fi or cellular connection
• Try switching between Wi-Fi and cellular
• Restart your router if using Wi-Fi
• Check if you're in an area with poor signal
• Try using a VPN if you're having regional issues

🔴 Error Codes & Meanings

• ERR_001 - Network connection failed
• ERR_002 - Authentication failed
• ERR_003 - Location services disabled
• ERR_004 - Account verification required
• ERR_005 - Server maintenance in progress
• ERR_006 - Rate limit exceeded
• ERR_007 - Feature not available in your region