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.
Franck Plazanet
I am a Strategic Engineering Leader with over 8 years of experience building high-availability enterprise systems and scaling high-performing technical teams. My focus is on bridging the gap between complex technology and business growth.
Core Expertise:
🚀 Leadership: Managing and coaching teams of 15+ engineers, fostering a culture of accountability and continuous improvement.
🏗️ Architecture: Enterprise Core Systems, Multi-system Integration (ERP/API/ETL), and Core Database Structure.
☁️ Cloud & Scale: AWS Expert; architected systems handling 10B+ monthly requests and managing 100k+ SKUs.
📈 Business Impact: Aligning tech strategy with P&L goals to drive $70k+ in monthly recurring revenue.
I thrive on "out-of-the-box" thinking to solve complex technical bottlenecks and am always looking for ways to use automation to improve business productivity.
AUXLE
I am a Full Stack Developer experienced in building Websites, Web apps and Cross Platform Mobile Apps for Startups and Companies.
Alvin Voo
I’ve watched the tech landscape evolve over the last decade—from the structured days of Java Server Pages to the current "wild west" of Agentic-driven development. While AI can "vibe" a frontend into existence, I specialize in the architecture that keeps it from collapsing.
My expertise lies in the critical backend infrastructure: the parts that must be fast, secure, and scalable. I thrive on high-pressure environments, such as when I had only three weeks to architect and launch an Ethereum redemption system with minimal prior crypto knowledge, turning it into a major revenue stream.
What I bring to your project:
Forensic Debugging: I don't just "patch" bugs; I use tools like Datadog and Explain Analyzers to map out bottlenecks and resolve root causes—like significantly reducing memory usage by optimizing complex DB joins.
Full-Stack Context: Deep experience in Node.js and React, ensuring backends play perfectly with mobile and web teams.
Sanity in the Age of AI: I bridge the gap between "best practices" and modern speed, ensuring your project isn't just built fast, but built to last.
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.
legrab
I'll fill this later
Matt Butler
Software Engineer @ AWS
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 : )
Pratik
SWE with 15+ years of experience building and maintaining web apps and extensive BE infrastructure
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.
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.