My App Won't Install on iPhone Home Screen
You built a web app and want users to be able to add it to their iPhone home screen so it feels like a real app. But when they try, nothing happens, it just opens as a regular browser tab, or the icon looks wrong. You wanted your app to feel like something from the App Store, but it doesn't.
This is about turning your website into a Progressive Web App (PWA) — basically making a website that can be "installed" on a phone without going through the App Store. When done right, it gets its own icon, opens full-screen, and feels like a native app.
Most AI tools don't set this up properly, or they miss key requirements that Apple specifically needs for iOS devices.
Error Messages You Might See
Common Causes
- Missing web app manifest — Your app doesn't have a special file that tells the phone what icon, name, and settings to use when installed
- No service worker — A service worker is a background script that Apple requires before it treats your site as an installable app
- Wrong icon sizes — Apple requires specific image sizes for home screen icons. If they're wrong, you get a generic screenshot instead
- Missing Apple-specific tags — iOS doesn't use the same standards as Android. You need special Apple tags in your HTML
- Site not on HTTPS — Both iOS and Android require your site to use HTTPS (secure connection) before it can be installed
How to Fix It
- Add a web app manifest file — Have a developer create a manifest.json file with your app name, icons, colors, and display settings
- Add Apple-specific meta tags — Include tags like apple-mobile-web-app-capable, apple-mobile-web-app-status-bar-style, and apple-touch-icon in your HTML
- Create proper icons — Generate home screen icons in the required sizes (at least 180x180 pixels for Apple)
- Add a basic service worker — Even a simple service worker file can satisfy the installation requirement
- Make sure HTTPS is working — Verify your site loads with the padlock icon in the browser bar
- Test the installation — On an iPhone, open Safari, tap the share button, and choose "Add to Home Screen" to test
Real developers can help you.
Mehdi Ben Haddou
- Founder of Chessigma (1M+ users) & many small projects
- ex Founding Engineer @Uplane (YC F25)
- ex Software Engineer @Amazon and @Booking.com
Krishna Sai Kuncha
Experienced Professional Full stack Developer with 8+ years of experience across react, python, js, ts, golang and react-native. Developed inhouse websearch tooling for AI before websearch was solved : )
Bastien Labelle
Full stack dev w/ 20+ years of experience
Yovel Cohen
I got a lot of experience in building Long-horizon AI Agents in production, Backend apps that scale to millions of users and frontend knowledge as well.
Richard McSorley
Full-Stack Software Engineer with 8+ years building high-performance applications for enterprise clients. Shipped production systems at Walmart (4,000+ stores), Cigna (20M+ users), and Arkansas Blue Cross. 5 patents in retail/supply chain tech. Currently focused on AI integrations, automation tools, and TypeScript-first architectures.
Anthony Akpan
Developer with 8 years of experience building softwares fro startups
Dor Yaloz
SW engineer with 6+ years of experience,
I worked with React/Node/Python
did projects with React+Capacitor.js for ios
Supabase expert
Matthew Jordan
I've been working at a large software company named Kainos for 2 years, and mainly specialise in Platform Engineering. I regularly enjoy working on software products outside of work, and I'm a huge fan of game development using Unity. I personally enjoy Python & C# in my spare time, but I also specialise in multiple different platform-related technologies from my day job.
Nam Tran
10 years as fullstack developer
Kingsley Omage
Fullstack software engineer passionate about AI Agents, blockchain, LLMs.
Describe what's wrong in plain English. No technical knowledge needed.
Get HelpFrequently Asked Questions
Is this the same as putting my app in the App Store?
No. This makes your website installable as a 'web app' directly from the browser, without going through the App Store. It's free, doesn't require Apple approval, and works by adding your site to the home screen. It won't appear in the App Store.
Why does it work on Android but not iPhone?
Android (Chrome) and iOS (Safari) have different requirements for installable web apps. iOS requires Apple-specific HTML tags and only works in Safari — not Chrome or other browsers on iPhone. Android is generally more flexible about PWA installation.