PWA Pro

PWA Pro is a comprehensive boilerplate for building iOS-optimised Progressive Web Apps using Next.js. It was created to explore and solve the many quirks of iOS when it comes to installable web apps — and to productise the solution so others can get started quickly.

Vision

The goal was simple: create the best possible onboarding and install experience for PWAs on iOS, and turn those learnings into a starter kit for developers. While Android has great support for web apps, iOS still has subtle (and not-so-subtle) limitations that require careful workarounds.

This project gave me a chance to go deep into PWA capabilities, browser behaviour, mobile UX, and the edges of what’s possible — and package it all up into a clean, modern developer experience.

Key Features

• PWA Config

  • Web App Manifest
  • Service Worker via Workbox
  • Offline support
  • Push notification integration
  • Background sync

• iOS Optimisation

  • Safe area insets (for notches, toolbars)
  • Home screen splash screens
  • App icon and theme setup
  • Standalone mode detection and routing
  • Custom install prompt UX
  • iOS-specific scroll and input fixes

• Developer Experience

  • Next.js + TypeScript
  • Tailwind CSS
  • ESLint + Prettier
  • Ready-to-go build pipeline
  • Example routes and UI components
  • MDX-based docs and README

Outcome

PWA Pro makes it easy to launch a well-behaved, installable web app that feels great on iOS and Android alike. It’s opinionated where it matters and flexible where it counts — with clear docs and enough built-in UX polish to help developers hit the ground running.

Whether you're building a startup MVP or a side project, PWA Pro gives you a strong head start with all the tricky bits handled.