Troubleshooting Guide

Simple solutions to common problems. Don't worry - most issues are easy to fix!

🚨 Most Common Problems

App Won't Start

Problem: App crashes when you try to run it

Quick Fix:

flutter clean
flutter pub get
flutter run

If that doesn't work:

• Restart your computer
• Check if Flutter is installed correctly
• Make sure your phone/emulator is connected

Can't Connect to Website

Problem: App shows "connection error" or "network error"

Quick Fix:

1. Check your .env file
2. Make sure API_BASE_URL=https://your-website.com is correct
3. Test your website in a browser first

Common mistakes:

• Wrong website URL
• Website is down
• No internet connection

Login Doesn't Work

Problem: Users can't login to the app

Quick Fix:

1. Test login on your website first
2. Make sure the website login works
3. Check if API is enabled on your website

If still not working:

• Contact your website developer
• Check if user accounts exist
• Try creating a new test account

No Products Showing

Problem: App loads but no products appear

Quick Fix:

1. Make sure you have products on your website
2. Check if categories are set up correctly
3. Try refreshing the app (pull down on the screen)

If still empty:

• Check your website has products
• Make sure products are published/active
• Contact your website developer

Social Login Not Working

Problem: Google/Facebook/Apple login fails

Quick Fix:

1. Check the setup guides:

   • Google Login
   • Facebook Login
   • Apple Login

2. Make sure you followed all steps exactly

3. Test regular email login first

🔧 Setup Problems

Colors Not Changing

Problem: Changed colors but app still looks the same

Solution:

1. Make sure you saved the file
2. Stop the app completely
3. Run: flutter clean
4. Start the app again

App Name Not Changing

Problem: Changed app name but it's still "MartFury"

Solution:

1. Follow guide 04_app_name.md exactly
2. Change it in BOTH Android and iOS files
3. Rebuild the app completely

Logo Not Changing

Problem: Changed logo files but old logo still shows

Solution:

1. Make sure image files are the right size
2. Replace ALL logo files (there are many)
3. Follow guide 05_app_logo.md
4. Clean and rebuild the app

📱 App Store Problems

Can't Upload to Google Play

Problem: Error when trying to upload app

Solution:

1. Follow guide 09_deploying_app.md exactly
2. Make sure you have a Google Play Developer account
3. Check file format (should be .aab not .apk)

Can't Upload to Apple App Store

Problem: Error when trying to upload to App Store

Solution:

1. Make sure you have Apple Developer account ($99/year)
2. Use Xcode to upload (not just the command line)
3. Check all certificates are valid

💡 Quick Fixes for Everything

The "Magic" Fix

When nothing else works, try this:

flutter clean
flutter pub get
flutter run

This fixes about 80% of all problems!

Restart Everything

Sometimes you just need to restart:

1. Close the app
2. Restart your phone/emulator
3. Restart your computer
4. Try again

Check the Basics

Before asking for help:

• ✅ Is your internet working?
• ✅ Is your website online?
• ✅ Did you save all your changes?
• ✅ Did you follow the guides exactly?

🆘 When to Ask for Help

You Should Try First

• Read the error message carefully
• Try the "magic fix" above
• Check the setup guides (01-15)
• Restart everything

Ask for Help When

• You get the same error after trying everything
• You don't understand the error message
• Something worked before but stopped working
• You're completely stuck

How to Ask for Help

When contacting support, include:

1. What you were trying to do
2. What error message you saw (screenshot if possible)
3. What you already tried
4. Your website URL
5. What device/computer you're using

Remember: There's no such thing as a stupid question! Everyone gets stuck sometimes, and most problems have simple solutions.