Get "PHP 8 in a Nuthshell" (Soon includes PHP 8.4)
Amit Merchant

Amit Merchant

A blog on PHP, JavaScript, and more

Enabling Richer PWA Install UI on Desktop

When I wrote this article about adding support for showing app screenshots in the install UI, there wasn’t a way to do the same on the desktop.

In essence, to enable the richer install UI with screenshots, you need to add a screenshots property to the manifest.json file. This property is an array of objects, each object representing a screenshot.

{
    ...
    "screenshots": [
        {
            "src": "img/mobile-screenshot1.png",
            "type": "image/png",
            "sizes": "540x720"
        },
        {
            "src": "img/mobile-screenshot2.png",
            "type": "image/png",
            "sizes": "540x720"
        }
    ],
    ...
}

I have enabled this on my Notepad app if you want to see it in action.

Now, we have got the same richer install UI on desktop with screenshots along with other information such as app description on the desktop as well.

For this to work, we need to add additional screenshots objects but with a new property called form_factor set to “wide”.

{
    ...
    "screenshots": [
        {
            "src": "img/desktop-screenshot1.png",
            "type": "image/png",
            "sizes": "2460x1674",
            "form_factor": "wide"
        },
        {
            "src": "img/desktop-screenshot2.png",
            "type": "image/png",
            "sizes": "2460x1674",
            "form_factor": "wide"
        }
    ],
    ...
}

You can verify that the screenshots are correctly added or not in the DevTools “Application” tab.

Screenshots in DevTools

Once added, you can see the richer install UI when installing the app on a desktop (Chrome) like so.

Desktop Install UI

One thing to note here is that the aspect ratio of all the screenshots that you want to show in the install UI should be the same otherwise the screenshots with odd aspect ratios will be ignored.

Like this article?

Buy me a coffee

👋 Hi there! I'm Amit. I write articles about all things web development. You can become a sponsor on my blog to help me continue my writing journey and get your brand in front of thousands of eyes.

Comments?