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.
Vlad Temian
15+ years shipping production infrastructure for startups. Former CTO at qed.builders (acquired by The Sandbox).
Cursor ambassador and agentic tooling builder.
I've scaled systems, automated deployments, and built observability tools for AI coding workflows. I specialize in taking vibe-coded apps from broken prototype to production-ready: fixing Supabase auth/RLS, Stripe integrations, deployment pipelines, and cleaning up AI-generated spaghetti.
I build tools in this space (agentprobe, claudebin, micode) and understand both sides: how AI generates code and why it breaks.
https://blog.vtemian.com/
Bastien Labelle
Full stack dev w/ 20+ years of experience
zipking
I am a technologist and product builder dedicated to creating high-impact solutions at the intersection of AI and specialized markets. Currently, I am focused on PropScan (EstateGuard), an AI-driven SaaS platform tailored for the Japanese real estate industry, and exploring the potential of Archify.
As an INFJ-T, I approach development with a "systems-thinking" mindset—balancing technical precision with a deep understanding of user needs. I particularly enjoy the challenge of architecting Vertical AI SaaS and optimizing Small Language Models (SLMs) to solve specific, real-world business problems. Whether I'm in a CTO-level leadership role or hands-on with the code, I thrive on building tools that turn complex data into actionable value.
Taufan
I’m a product-focused engineer and tech leader who builds scalable systems and turns ideas into production-ready platforms.
Over the past years, I’ve worked across startups and fast-moving teams, leading backend architecture, improving system reliability, and shipping products used by thousands of users. My strength is not just writing code — but connecting product vision, technical execution, and business impact.
Matthew Butler
Systems Development Engineer @ Amazon Web Services
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.
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.
Meïr Ankri
Full-stack developer specializing in React / Next.js / Node.js with 6+ years of experience. I've worked across various sectors including automotive (Reezocar/Société Générale), healthcare (Medical Link SaaS), and e-commerce (Glasman). I build web apps end-to-end, from architecture to production, with a focus on scalability, performance, and code quality. I also mentor junior developers and contribute to technical decisions and code reviews.
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.
BurnHavoc
Been around fixing other peoples code for 20 years.
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.