Common Issues
mobile
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
No error message — the option to install just doesn't appear or doesn't work properly
App opens in Safari instead of standalone
Icon shows as a screenshot instead of your logo
Site cannot be installed — no manifest found
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.
Victor Denisov
Developer
Jen Jacobsen
I’m a Full-Stack Developer with over 10 years of experience building modern web and mobile applications. I enjoy working across the full product lifecycle — turning ideas into real, well-built products that are intuitive for users and scalable for businesses.
I particularly enjoy building mobile apps, modern web platforms, and solving complex technical problems in a way that keeps systems clean, reliable, and easy to maintain.
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.
rayush33
JavaScript (React.js, React Native, Node.js) Developer with demonstrated industry experience of 4+ years, actively looking for opportunities to hone my skills as well as help small-scale business owners with solutions to technical problems
Milan Surelia
Milan Surelia is a Mobile App Developer with 5+ years of experience crafting scalable, cross-platform apps at 7Span and Meticha. At 7Span, he engineers feature-rich Flutter apps with smooth performance and modern UI. As the Co-Founder of Meticha, he builds open-source tools and developer-focused products that solve real-world problems.
Expertise:
💡 Developing cross-platform apps using Flutter, Dart, and Jetpack Compose for Android, iOS, and Web.
🖋️ Sharing insights through technical writing, blogging, and open-source contributions.
🤝 Collaborating closely with designers, PMs, and developers to build seamless mobile experiences.
Notable Achievements:
🎯 Revamped the Vepaar app into Vepaar Store & CRM with a 2x performance boost and smoother UX.
🚀 Launched Compose101 — a Jetpack Compose starter kit to speed up Android development.
🌟 Open source contributions on Github & StackOverflow for Flutter & Dart
🎖️ Worked on improving app performance and user experience with smart solutions.
Milan is always happy to connect, work on new ideas, and explore the latest in technology.
Pratik
SWE with 15+ years of experience building and maintaining web apps and extensive BE infrastructure
Sage Fulcher
Hey I'm Sage! Im a Boston area software engineer who grew up in South Florida. Ive worked at a ton of cool places like a telehealth kidney care startup that took part in a billion dollar merger (Cricket health/Interwell health), a boutique design agency where I got to work on a ton of exciting startups including a photography education app, a collegiate Esports league and more (Philosophie), a data analytics as a service startup in Cambridge (MA) as well as at Phillips and MIT Lincoln Lab where I designed and developed novel network security visualizations and analytics. I've been writing code and furiously devoted to using computers to make people’s lives easier for about 17 years. My degree is in making computers make pretty lights and sounds. Outside of work I love hip hop, the Celtics, professional wrestling, magic the gathering, photography, drumming, and guitars (both making and playing them)
Tejas Chokhawala
Full-stack engineer with 5 years experience building production web apps using React, Next.js and TypeScript.
Focused on performance, clean architecture and shipping fast.
Experienced with Supabase/Postgres backends, Stripe billing, and building AI-assisted developer tools.
Simon A.
I'm a backend developer building APIs, emulators, and interactive game systems. Professionally, I've developed Java/Spring reporting solutions, managed relational and NoSQL databases, and implemented CI/CD workflows.
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.