The app that loaded my laptop
Your Capacitor app works perfectly on your phone at home. Your tester opens the same TestFlight build at work and sees a blank white screen.
This answers: Why is my Capacitor app a blank white screen? No coding needed. 3 quick decisions.
- Keeping it running
- How a request travels
Checking your access…
Why is my Capacitor app a blank white screen?
A common cause is a server.url left in capacitor.config from live reload. The app then loads pages from your laptop's development server, which only exists on your home Wi-Fi, so everyone else sees a blank screen. Remove server.url for release builds, build the web app, and run npx cap sync so the files ship inside the app.
Breaks at Your laptop: App loads pages from a dev server
Why AI tools write this bug
AI tools add server.url to get live reload working on your phone, and nothing reminds anyone to take it out before release.
How to fix it
- Remove server.url and cleartext from release config.
- Build the web app, then run npx cap sync.
- Keep live reload settings in a development-only config.
- Test release builds away from your home network.
Check your own app
Paste this into Lovable, Cursor or Claude Code:
Without changing anything, show me this project's Capacitor config and any environment-specific versions of it. Tell me whether server.url or cleartext is set, which builds would use them, where the app loads its pages from in a release build, and what happens with no internet connection.
Common questions
- What else causes a blank Capacitor screen?
- A wrong webDir, a build that wasn't synced, or a JavaScript error on start. Connect the phone and check Safari or Chrome's remote inspector for errors.