Font Sizes Too Small on Mobile in Windsurf App
Text in your Windsurf-generated app is tiny and unreadable on mobile devices. Users have to pinch-zoom to read content, form labels are barely visible, and the overall experience feels like viewing a desktop site on a phone. iOS Safari may also auto-zoom on input fields, causing disorienting layout shifts.
This is a common problem with AI-generated apps that were designed primarily for desktop viewing. Cascade generates layouts that look great on a large screen but doesn't always scale typography for smaller devices. Even when the layout is responsive, font sizes may remain at desktop values.
Poor text readability on mobile is both a usability problem and an accessibility issue. Google's mobile-friendly test penalizes pages with text smaller than 16px, which can hurt your search rankings.
Error Messages You Might See
Common Causes
- Fixed pixel font sizes — Cascade set font-size: 12px or 14px that looks fine on desktop but is too small on a phone held at arm's length
- Missing viewport meta tag — Without a proper viewport tag, mobile browsers render at desktop width and scale down everything
- Desktop-only typography scale — The font sizes are designed for desktop and never adjusted for mobile breakpoints
- Input font-size under 16px — Form inputs with font-size less than 16px trigger auto-zoom in iOS Safari, creating a poor experience
- Relative units chained poorly — Nested elements with em-based sizes compound to extremely small values on mobile
How to Fix It
- Set a 16px minimum base font size — Ensure body font-size is at least 16px. Use rem units for all other text sizes relative to this base
- Use responsive font sizing — Use clamp() for fluid typography: font-size: clamp(1rem, 2.5vw, 1.5rem) scales smoothly between mobile and desktop
- Set input font-size to 16px+ — Any form input with font-size below 16px causes iOS Safari to auto-zoom. Set font-size: 16px or 1rem on all inputs
- Verify viewport meta tag — Ensure your HTML has <meta name="viewport" content="width=device-width, initial-scale=1.0">
- Increase line-height for readability — Set line-height: 1.5 or higher on body text for comfortable reading on small screens
- Test at actual phone distance — Hold your phone at normal reading distance. If you squint to read any text, it's too small
Real developers can help you.
You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.
Get HelpFrequently Asked Questions
What is the minimum recommended font size for mobile?
The minimum readable font size on mobile is 16px for body text. Use 14px only for secondary information like captions. Never go below 12px for any text. Form inputs must be 16px or larger to prevent iOS Safari auto-zoom.
Why does iOS Safari zoom in when I tap an input field?
iOS Safari automatically zooms to 16px when you focus an input with a smaller font-size. This is a deliberate accessibility feature. The fix is to set font-size: 16px (or 1rem with a 16px base) on all input, select, and textarea elements.