You built your app, opened it on your laptop, and it looked great. The layout was clean, the buttons lined up, the colors popped. You shared the link, felt proud, and moved on. Then someone opened it on their phone and the whole thing fell apart: text running off the edge of the screen, buttons stacked on top of each other, a menu you can't even tap.

I see this almost every week. A founder ships an AI-built app that looks polished on a big screen, and then discovers it's basically unusable on mobile, which is exactly where most of their real users are. If your AI-built app is not mobile responsive, you're not looking at a small cosmetic issue. You're losing the majority of the people who show up.

Here's the frustrating part: the tool that built your app made it look done. But "looks done on my laptop" and "works on a phone" are two completely different bars, and AI coding tools clear the first one while quietly failing the second. In this post I'll walk you through why that happens, how to spot the broken spots yourself, and what I actually check to make an app usable on every screen size.

What "mobile responsive" really means

Let me define the term plainly, because it gets thrown around a lot. A responsive app is one that reshapes itself to fit whatever screen it's on. On a wide laptop it might show three columns side by side. On a narrow phone those same columns stack into one, the text stays readable, and every button is big enough to tap with a thumb.

The magic that makes this happen is a set of rules called breakpoints. A breakpoint is just a line in the sand that says "when the screen gets narrower than this width, change the layout." Good responsive design has these rules baked in everywhere. Bad responsive design has them in a few places and forgets the rest.

When people say an app "isn't mobile responsive," they usually mean one of these things:

  • Content overflows the screen and you have to scroll sideways to read it.
  • Text is so tiny you have to pinch and zoom.
  • Buttons and links are too small or too close together to tap accurately.
  • The navigation menu never collapses into something usable on a small screen.
  • Things overlap or get cut off entirely.

Any one of these makes your app feel broken to a phone user, even if it's flawless on desktop.

Why AI coding tools ship desktop-only layouts

This is where my experience comes in, because the reason is consistent and it's baked into how these tools work.

AI builders generate what they're shown and what they're asked for, and they optimize for the view right in front of them. When you're prompting in Cursor, Lovable, Bolt, or v0, you're almost always looking at a wide preview window on a desktop screen. The AI builds to make that preview look right. That's the happy path it's chasing: the layout that matches the frame you're staring at.

Mobile is an afterthought because nobody's staring at a phone while they build. The AI has no idea that 70 percent of your traffic will come from someone's cracked iPhone on a bus. It's not being lazy. It's just solving the problem you visibly handed it, which was "make this look good here."

There are a few more technical reasons this keeps happening:

  • Responsive rules are easy to skip and hard to notice missing. Adding mobile breakpoints is extra work that doesn't change how the desktop preview looks. So the AI often skips it, and you can't tell by looking at the screen it built.
  • AI loves fixed sizes. It frequently sets things to exact pixel widths ("this box is 900 pixels wide") instead of flexible ones ("this box is as wide as the screen allows"). A 900-pixel box does not fit on a 390-pixel phone. It just spills over.
  • It copies patterns from its training, and a lot of that is desktop-first. The examples these models learned from skew toward classic desktop web layouts, so that's what they reach for by default.

And here's the trap I watch founders fall into. They notice the mobile problem, paste a screenshot back into the AI, and ask it to "make it mobile friendly." Sometimes it patches one screen. Then it breaks the desktop version, or fixes the header but not the forms, and you're playing whack-a-mole. Using more AI to fix AI-built layout gaps tends to repeat the same blind spots. It's the same story I've written about with vibe-coding debt: the quick fix piles up more mess than it clears.

Your app doesn't have a mobile bug. It was never built for mobile in the first place, and that's a foundation problem, not a patch.

How to spot the broken breakpoints yourself

You don't need to read a single line of code to test this. You just need to look at your app the way your users actually will. Here's exactly how I'd check.

1. Open it on your own phone, as a real user

Not the preview inside the AI tool. Your actual phone, in a normal browser. Then go through the things a real person does: sign up, log in, fill out the main form, make a purchase, open the menu. Watch for text spilling off the edge, buttons you can't hit, or anything you have to zoom to read.

2. Use your desktop browser's mobile view

This is the fastest way to test lots of screen sizes without a drawer full of phones. In Chrome or Edge, right-click your app, choose Inspect, then click the little phone-and-tablet icon near the top. You can now switch between an iPhone, a small Android, an iPad, and more.

Right-click page  →  Inspect  →  click the phone/tablet icon
Then pick a device from the dropdown (iPhone SE is a great worst case)

Pick the smallest phone in the list first. The iPhone SE is narrow and a great worst-case test. If your app survives that, it'll usually survive everything bigger.

3. Drag your browser window narrow

Even simpler: grab the edge of your browser window and slowly drag it narrower. Watch what happens as it shrinks. A responsive app rearranges smoothly. A broken one hits a point where content suddenly overflows, overlaps, or gets clipped. The exact width where it breaks is your missing breakpoint.

4. Check the tap targets

On your phone, try to tap small links and buttons with your thumb, not a fingernail. If you keep hitting the wrong one, they're too small or too crowded. This one matters more than founders think, because a user who can't tap "Buy" doesn't buy.

5. Test in both orientations

Turn the phone sideways. Landscape mode exposes a whole new set of layout assumptions the AI never considered. Menus, modals, and full-screen forms often break here specifically.

If you find problems at several of these steps, that's normal. It doesn't mean you did anything wrong. It means the app was built desktop-first and never taught to adapt.

What I actually check to make an app work on every screen

When an app lands on my desk with mobile problems, I don't just start nudging elements around until the current screen looks okay. That's how you end up with a layout that's fixed on your phone and broken on someone else's. I work through the foundation. Here's the checklist.

Fix the sizing model, not the symptoms

The first thing I look for is fixed pixel widths that should be flexible. I replace rigid values with ones that flex to the screen, and I make sure there's a rule that stops anything from being wider than the screen it's on. This one change alone kills most of the sideways-scrolling nightmares.

Set real breakpoints across the whole app

I define a consistent set of breakpoints (phone, tablet, desktop) and apply them everywhere, not just on the homepage. The homepage getting attention while the checkout page overflows is one of the most common half-fixes I see. Every screen a user can reach needs to be tested at every size.

Make navigation work with a thumb

Desktop navigation bars almost never fit on a phone. I make the menu collapse into a tappable button (the "hamburger" menu most people recognize), and I make sure it actually opens, closes, and doesn't cover the content it's supposed to reveal.

Size images and media properly

AI-built apps love to drop in images at their full original size. On a phone, that means a photo blowing past the edges or a giant file that takes forever to load on mobile data. I constrain media to its container and make sure it scales down cleanly.

Confirm the viewport is actually set

There's one small but critical line that tells a phone to render the page at phone width instead of pretending to be a tiny desktop. AI tools sometimes leave it out. When they do, everything looks zoomed-out and tiny no matter what else is right.

<meta name="viewport" content="width=device-width, initial-scale=1" />

If that line is missing, a lot of "mobile is broken" complaints vanish the moment it's added.

Test the flows, not just the pages

A page can look fine sitting still and still fall apart when you use it. So I run the real journeys on a small screen: opening a menu, filling a form, hitting an error, dismissing a popup. Layout and behavior are different things, and mobile breaks both. This is the same reason I lean hard on proper QA on AI-built apps before anyone calls something finished.

What you can do right now versus what needs a real set of eyes

Let me be honest about the split, because I never want you to think you're helpless here.

You can absolutely do the detective work yourself. Testing on your phone, using the browser's mobile view, dragging the window narrow, listing every screen that breaks: all of that is yours, and it's genuinely valuable. Write down what you find, screen by screen, size by size. That list is gold.

You can also handle the small, safe fixes. If a chunk of text just needs to shrink on mobile, or an image needs to stop overflowing, and your app is safely backed up in version control so you can undo a bad change, that's a reasonable thing to try.

Where I'd bring in a real developer is when the fixes start touching the structure of the layout, or when patching one screen keeps breaking another. That back-and-forth is the tell. It means the underlying sizing model is wrong, and no amount of surface nudging will hold. Rebuilding the responsive foundation the right way, once, is faster and steadier than fifty prompts that each half-work.

It's also worth being realistic about the bigger picture. Mobile layout problems rarely travel alone. If the AI skipped responsive design, it very likely skipped other unglamorous things too, like real error handling and a solid backend. If your app is genuinely growing, those cracks tend to show up together, which I dug into in why AI-built apps break at scale.

You're closer than it feels

If you just discovered your app is unusable on phones, take a breath. This is one of the most fixable problems I deal with, and it's incredibly common. It doesn't mean the app is bad or that you made a mistake by building with AI. It means the tool did what these tools do: it made the screen in front of it look great and left the phones for later.

The good news is that "later" is now, and it's a solved problem when someone knows where to look. You've got a clear way to find the broken spots, and you know what a real fix involves versus a patch that'll fall over next week.

If you've tested your app on your phone and it's a mess, or you've been fighting the AI to fix it and it keeps breaking something else, that's exactly the kind of thing I sort out. I'll review your app across real screen sizes, find every place it breaks, and either fix the foundation or hand you a plain-English plan for what it needs. If getting your app working for the users who are actually on their phones would take a weight off your shoulders, let's talk.

Cover photo by Muffin Creatives on Pexels.