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
No error message — the option to install just doesn't appear or doesn't work properlyApp opens in Safari instead of standaloneIcon shows as a screenshot instead of your logoSite 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

  1. Add a web app manifest file — Have a developer create a manifest.json file with your app name, icons, colors, and display settings
  2. 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
  3. Create proper icons — Generate home screen icons in the required sizes (at least 180x180 pixels for Apple)
  4. Add a basic service worker — Even a simple service worker file can satisfy the installation requirement
  5. Make sure HTTPS is working — Verify your site loads with the padlock icon in the browser bar
  6. 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.

Rudra Bhikadiya Rudra Bhikadiya I build and fix web apps across Next.js, Node.js, and DBs. Comfortable jumping into messy code, broken APIs, and mysterious bugs. If your project works in theory but not in reality, I help close that gap. prajwalfullstack prajwalfullstack Hi Im a full stack developer, a vibe coded MVP to Market ready product, I'm here to help Matt Butler Matt Butler Software Engineer @ AWS Caio Rodrigues Caio Rodrigues I'm a full-stack developer focused on building practical and scalable web applications. My main experience is with **React, TypeScript, and modern frontend architectures**, where I prioritize clean code, component reusability, and maintainable project structures. I have strong experience working with **dynamic forms, state management (Redux / React Hook Form), and complex data-driven interfaces**. I enjoy solving real-world problems by turning ideas into reliable software that companies can actually use in their daily operations. Beyond coding, I care about **software quality and architecture**, following best practices for componentization, code organization, and performance optimization. I'm also comfortable working across the stack when needed, integrating APIs, handling business logic, and helping transform prototypes into production-ready systems. My goal is always to deliver solutions that are **simple, efficient, and genuinely useful for the people using them.** Basel Issmail Basel Issmail ’m a Senior Full-Stack Developer and Tech Lead with experience designing and building scalable web platforms. I work across the full development lifecycle, from translating business requirements into technical architecture to delivering reliable production systems. My work focuses on modern web technologies, including TypeScript, Angular, Node.js, and cloud-based architectures. I enjoy solving complex technical problems and helping teams turn product ideas and prototypes into working platforms that can grow and scale. In addition to development, I often collaborate closely with product managers, business analysts, designers, and QA teams to ensure that solutions align with both technical and business goals. I enjoy working with startups and product teams where I can contribute both as a hands-on engineer and as a technical partner in designing and delivering impactful software. Jared Hasson Jared Hasson Full time lead founding dev at a cyber security saas startup, with 10 yoe and a bachelor's in CS. Building & debugging software products is what I've spent my time on for forever Antriksh Narang Antriksh Narang 5 years+ Experienced Dev (Specially in Web Development), can help in python, javascript, react, next.js and full stack web dev technologies. Kingsley Omage Kingsley Omage Fullstack software engineer passionate about AI Agents, blockchain, LLMs. Milan Surelia 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. Simon A. 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 Help

Frequently 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.

Related Common Issues Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help