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:
- Check your
.env
file - Make sure
API_BASE_URL=https://your-website.com
is correct - 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:
- Test login on your website first
- Make sure the website login works
- 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:
- Make sure you have products on your website
- Check if categories are set up correctly
- 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:
Check the setup guides:
Make sure you followed all steps exactly
Test regular email login first
🔧 Setup Problems
Colors Not Changing
Problem: Changed colors but app still looks the same
Solution:
- Make sure you saved the file
- Stop the app completely
- Run:
flutter clean
- Start the app again
App Name Not Changing
Problem: Changed app name but it's still "MartFury"
Solution:
- Follow guide 04_app_name.md exactly
- Change it in BOTH Android and iOS files
- Rebuild the app completely
Logo Not Changing
Problem: Changed logo files but old logo still shows
Solution:
- Make sure image files are the right size
- Replace ALL logo files (there are many)
- Follow guide 05_app_logo.md
- Clean and rebuild the app
📱 App Store Problems
Can't Upload to Google Play
Problem: Error when trying to upload app
Solution:
- Follow guide 09_deploying_app.md exactly
- Make sure you have a Google Play Developer account
- 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:
- Make sure you have Apple Developer account ($99/year)
- Use Xcode to upload (not just the command line)
- 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:
- Close the app
- Restart your phone/emulator
- Restart your computer
- 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:
- What you were trying to do
- What error message you saw (screenshot if possible)
- What you already tried
- Your website URL
- 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.