Replit mobile

PWA Install Not Working on Replit-Hosted App

You built a Progressive Web App (PWA) with AI tools and deployed it on Replit, but the browser never shows the "Add to Home Screen" or "Install App" prompt. The app cannot be installed on phones or desktops as a standalone application.

PWA installation requires several technical criteria to be met: a valid web app manifest, a registered service worker, HTTPS, and specific icon sizes. Missing any one of these silently prevents installation without any error message to the user.

AI-generated PWA configurations are frequently incomplete — the manifest may have wrong paths, the service worker may fail to register, or required icon sizes may be missing. Replit's deployment URL structure can also cause path issues with manifest and service worker files.

Error Messages You Might See

Site cannot be installed: no matching service worker detected Manifest: property 'icons' must contain a 192x192px icon Site cannot be installed: does not meet criteria for installability Failed to register a ServiceWorker: script has unsupported MIME type
Site cannot be installed: no matching service worker detectedManifest: property 'icons' must contain a 192x192px iconSite cannot be installed: does not meet criteria for installabilityFailed to register a ServiceWorker: script has unsupported MIME type

Common Causes

  • Invalid or missing manifest.json — the web app manifest file is missing, has wrong paths, or has invalid JSON
  • Service worker not registering — the service worker file is not found or throws errors during registration
  • Missing required icons — PWA requires specific icon sizes (192x192 and 512x512 minimum) that are not provided
  • Wrong start_url in manifest — the start URL does not match the actual deployment path on Replit
  • Service worker scope mismatch — the service worker's scope does not cover the app's pages

How to Fix It

  1. Validate your manifest — use Chrome DevTools > Application > Manifest to check for errors and warnings
  2. Check service worker registration — go to DevTools > Application > Service Workers and verify it is registered and active
  3. Add required icon sizes — include at least 192x192 and 512x512 PNG icons referenced correctly in the manifest
  4. Fix start_url — set start_url to "/" or your app's root path relative to the Replit deployment
  5. Run Lighthouse PWA audit — Chrome's Lighthouse tool specifically checks all PWA installability criteria

Real developers can help you.

Alvin Voo 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. Meïr Ankri 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. Costea Adrian Costea Adrian Embedded Engineer specilizing in perception systems. Latest project was a adas camera calibration system. Jacek Rozanski Jacek Rozanski Senior PHP/Symfony developer and DevOps engineer with 20+ years of professional experience, running opcode.pl (web development agency, est. 2004). Day job: I'm the sole backend developer at merketing company where I own and maintain 11 PHP/Symfony microservices on AWS (ECS Fargate, RDS, S3, CloudFront), handle the full CI/CD pipeline (Bitbucket Pipelines, Docker), and manage monitoring with Sentry and CloudWatch. These services handle high request volumes in production every month. What I bring to AI-built apps: - I audit and fix security issues (OWASP methodology), performance bottlenecks, and architectural problems in codebases generated by Cursor, Claude Code, Lovable, Bolt, and v0 - I refactor AI-generated prototypes into production-grade applications with proper error handling, testing, and clean architecture (SOLID, DDD, hexagonal architecture) - I set up the infrastructure AI tools don't touch: AWS hosting, CI/CD pipelines, automated deployments, database optimization, monitoring, and alerting - I integrate external services: payment providers, email systems, partner APIs, SSO/auth Tech stack: PHP 8.x, Symfony, React, Next.js, PostgreSQL, MySQL, Docker, AWS (ECS, RDS, S3, SQS/SNS, CloudFront), Terraform, Supabase. I also use AI tools daily (Claude Code, Cursor) in my own workflow, so I understand both the strengths and the gaps in AI-generated code. Based in Poland (CET timezone). Available for async work and calls during EU/US business hours. Matthew Butler Matthew Butler Systems Development Engineer @ Amazon Web Services MFox MFox Full-stack professional senior engineer (15+years). Extensive experience in software development, qa, and IP networking. Dor Yaloz 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 Tejas Chokhawala 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. Kingsley Omage Kingsley Omage Fullstack software engineer passionate about AI Agents, blockchain, LLMs. Matthew Jordan 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.

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

Get Help

Frequently Asked Questions

How do I check if my PWA is installable?

Open Chrome DevTools, go to Application > Manifest. Chrome will list any issues preventing installation. You can also run a Lighthouse audit under the PWA category.

Does Replit support PWA hosting?

Yes, Replit serves your app over HTTPS which is required for PWAs. You just need to ensure your manifest.json, service worker, and icons are correctly configured.

What icon sizes does a PWA need?

At minimum, you need 192x192 and 512x512 pixel PNG icons. Some platforms also benefit from a 384x384 icon and a maskable icon version.

Related Replit 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