Cover the entire screen with your PWA on iOS

maandag 6 oktober 2025 - 197 woorden, 1 min read

When you add a website as a progressive web app (PWA) on your iOS device, Apple avoids content being hidden below the notches. But with some tweaks we can cover the entire screen so your PWA will feel even more native.

In the example below, the notch is black but this color can be set to any color with the theme-color property specified in the manifest.json file.

To remove this behaviour you need to add / update the following meta elements in your HTML head element:

<meta name="viewport" content="initial-scale=1, viewport-fit=cover, width=device-width"></meta>
<meta name="apple-mobile-web-app-capable" content="yes"></meta>
<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent"></meta>

Now when you check your PWA on your iOS device, you will see that the content is covered under the notches. Example: https://shares.sebastix.dev/ZZloHXni.png#db91c787c1bf4a66f3eb986e4d16081a594d01f8c7ff487d53852e9797184af1

Now with some CSS it is up to you to set the margins or paddings to the elements to make sure that all elements are aligned properly. The screenshot above is from https://ccns.news which is a Drupal website with a custom theme where I use TailwindCSS to apply styling. With just one line of CSS I fixed the padding. For the HTML header element I’ve added this CSS code: padding-top: env(safe-area-inset-top,0);.

Result:

Please visit https://dev.to/karmasakshi/make-your-pwas-look-handsome-on-ios-1o08 with some more technical details how to set paddings which might help you.

This commit shows how I’ve applied the same trick within a TailwindCSS styled + Nuxt powered progressive web application (https://nuxstr.nostrver.se).

More resources


Sebastian Hagens @Sebastix
I work as creative webdeveloper & tech consultant and care about digital freedoms. Follow me:
or visit my contact page