Skip to main content

Common Scenarios

Real solutions for real situations. Find your scenario and get the answer.

UI & Layout Issues

The problem: Long text doesn’t fit and gets truncated.Solutions:For truncation with ellipsis:
For wrapping:
For scrolling:
The problem: UI elements are positioned incorrectly.Solutions:Be specific about spacing:
Use proper layout:
The problem: Content appears in unsafe areas of the screen.Solution:
The problem: Can’t see what you’re typing because the keyboard is in the way.Solution:
The problem: Items in a list are too close together.Solution:

Data & Storage Issues

The problem: Nothing is saved between sessions.Solution:
For simple settings:
The problem: No way to remove data.Solutions:Swipe to delete:
Delete button:
The problem: App feels sluggish loading data.Solutions:Add loading state:
Load progressively:
The problem: Search results aren’t helpful.Solution:

The problem: No back button or back gesture.Solution:
The problem: Tab bar disappears on certain screens.Solution:

Performance Issues

The problem: UI isn’t responsive.Solutions:For list performance:
For image performance:
General:
The problem: Initial build is very slow.This is normal. First builds take 30-60 seconds because Xcode compiles everything. Subsequent builds are much faster (5-15 seconds).If it’s consistently slow:
  • Close other applications
  • Ensure sufficient disk space (10GB+)
  • Restart your Mac
The problem: App runs slowly in Simulator.Solutions:
  • 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

The problem: Connection fails.Checklist:
  1. Verify project URL (ends in .supabase.co)
  2. Use the anon key, not service_role
  3. Check if project is initialized (takes ~2 min after creation)
  4. Ensure internet connection
Tell the AI:
The problem: Local changes don’t sync.Check:
  1. RLS policies allow inserts
  2. User is authenticated (if required)
  3. Required fields have values
Tell the AI:
The problem: Sign up or login fails.Check in Supabase:
  1. Authentication → Users: is the user created?
  2. Authentication → Settings: is email confirmation enabled?
  3. For testing, you can disable email confirmation
Tell the AI:
The problem: Changes don’t sync between devices.Check:
  1. Real-time is enabled in Supabase (default: on)
  2. Subscriptions are set up correctly
  3. RLS policies allow selects
Tell the AI:

API Integration Issues

The problem: External API calls fail.Tell the AI:
Common causes:
  • Invalid API key
  • Wrong endpoint URL
  • Missing required parameters
  • Rate limiting
The problem: API returns data but it doesn’t display correctly.Tell the AI:
Then:

Media & Files

Note: Camera doesn’t work in Simulator. You must test on a real device via TestFlight.If permission issues:
The problem: Images don’t display.For local images:
For remote images:
The problem: App slows down or crashes with large images.Solution:

App Behavior

Possible causes:
  1. Missing required data
  2. Force unwrapping a nil value
  3. Permissions not configured
Tell the AI:
Possible causes:
  1. Button action not connected
  2. Action throws an error silently
  3. UI is blocking the button
Tell the AI:
The problem: Data changes but UI stays the same.Tell the AI:

Still Stuck?

Debugging Guide

Comprehensive debugging walkthrough

How Do I...

Quick answers to common questions

FAQs

More troubleshooting Q&A

Discord

Get help from the community