Common Scenarios
Real solutions for real situations. Find your scenario and get the answer.UI & Layout Issues
Text is getting cut off
Text is getting cut off
Items overlap or are misaligned
Items overlap or are misaligned
Content goes under the notch or home indicator
Content goes under the notch or home indicator
Keyboard covers input fields
Keyboard covers input fields
List items look crowded
List items look crowded
Data & Storage Issues
Data disappears when app closes
Data disappears when app closes
Can't delete items
Can't delete items
Data loads slowly
Data loads slowly
Search doesn't work well
Search doesn't work well
Navigation Issues
Can't go back to previous screen
Can't go back to previous screen
Tab bar doesn't show on all screens
Tab bar doesn't show on all screens
Modal/sheet won't dismiss
Modal/sheet won't dismiss
Performance Issues
App is slow or laggy
App is slow or laggy
First build takes forever
First build takes forever
- Close other applications
- Ensure sufficient disk space (10GB+)
- Restart your Mac
Simulator is slow
Simulator is slow
- Use a simpler device (iPhone SE vs iPhone 15 Pro Max)
- Close other Simulators
- The Simulator is always slower than real devices — test on TestFlight for true performance
Supabase/Cloud Issues
Can't connect to Supabase
Can't connect to Supabase
- Verify project URL (ends in
.supabase.co) - Use the
anonkey, notservice_role - Check if project is initialized (takes ~2 min after creation)
- Ensure internet connection
Data not saving to cloud
Data not saving to cloud
- RLS policies allow inserts
- User is authenticated (if required)
- Required fields have values
Authentication not working
Authentication not working
- Authentication → Users: is the user created?
- Authentication → Settings: is email confirmation enabled?
- For testing, you can disable email confirmation
Real-time updates not working
Real-time updates not working
- Real-time is enabled in Supabase (default: on)
- Subscriptions are set up correctly
- RLS policies allow selects
API Integration Issues
API returns error
API returns error
- Invalid API key
- Wrong endpoint URL
- Missing required parameters
- Rate limiting
Data format is wrong
Data format is wrong
Media & Files
Camera not working
Camera not working
Images not loading
Images not loading
Large images causing issues
Large images causing issues
App Behavior
App crashes on launch
App crashes on launch
- Missing required data
- Force unwrapping a nil value
- Permissions not configured
Nothing happens when I tap a button
Nothing happens when I tap a button
State doesn't update the UI
State doesn't update the UI