DEV Community

Cover image for #16 - Tools: Getting Started / Converting your web app to a PWA
Nitya Narasimhan, Ph.D for Microsoft Azure

Posted on • Originally published at

#16 - Tools: Getting Started / Converting your web app to a PWA

Welcome to Day 16 of #30DaysOfPWA! New to the series? Three things you can do to catch up:

This is a shortened version of this canonical post for the #30DaysOfPWA.

About The Author

Today's post is authored by Amrutha Srinivasan - a software engineer on the PWABuilder team at Microsoft. Follow Amrutha at @amruthasrin or here on

Welcome to day week 3 day 2 of the 30 Days of PWA series! Yesterday we talked about the great tools that are out there to build a top quality PWA from scratch. Today we will talk about, another offering under the PWABuilder project that allows you to easily evaluate and publish your PWA to different app stores.

What is PWABuilder?

PWABuilder is a project designed to make building and packaging good quality PWAs a smooth experience for developers. is a one-stop shop to evaluate and publish your PWA to app stores in a matter of minutes. It strives to achieve the following:

  • Create and publish your PWA package to multiple app stores such as the Microsoft store. It eliminates the need to understand the native code or underlying platforms in order to submit to these stores.
  • Evaluate the quality of your PWA by analyzing the manifest and service worker, and give you recommendations of what can be improved to make your PWA even better.
  • Edit your manifest and add more advanced features to your service worker. This means that even if you have a non-PWA website, you can easily convert it into a PWA just by choosing the right “ingredients” from the manifest and service worker options that we provide.

Fun fact, is itself a PWA! It's also completely open source, along with all the other great tools that are part of the PWABuilder suite.

How it works

Let’s now deep dive into what PWABuilder can do for you. The PWA we are going to use in this walkthrough is Webboard, an open source Whiteboarding app.

First, we enter the URL on the homepage of PWABuilder.

Enter a URL on the homepage

You will be taken to this report card page that tells you your score for each component of the PWA. As you can see the scoring is divided into three sections : Manifest, Service Worker and Security. In each of these sections there are a number of items that your PWA is evaluated based on. This is all to ensure that your PWA meets all the criteria and quality standards so that it is usable, secure and easily discoverable in any of the app stores.

Report card page on

Under the tab “Manifest Options” you can add more details to your manifest. Here you can generate icons of all the sizes needed by the various app stores, as well as screenshots that will appear on the product detail pages (PDP) when a user looks up your app in the store. To learn more about the web app manifest and why it is important, refer to one of our previous articles.

Edit your manifest on

If you don’t have a service worker or would like to improve on your existing one based on your score, go to the “Service Worker Options” Tab. Here there is code provided for service workers that offer advanced functionality such as an offline experience and caching media files. To understand more about service workers, refer to this article.

Edit your Service worker and add new capabilities

When you’re happy with all the changes you have made, you are now ready to publish! generates packages for your PWA for many app stores such as the Microsoft Store, iOS App store and the Google Play Store.

Publish page on PWABuilder

There you have it, folks! That’s how quickly you can convert your website to a PWA, or add some more of the rich platform capabilities to your existing PWA that can then be published to various app stores!

Why should you use PWABuilder?

Simply having a web app manifest and a service worker does not necessarily make a good PWA. Tools like, pwa-starter and the PWA Studio VS Code extension, can help your app reach its potential by harnessing all the powers of PWA technology. Whether you want to start building from scratch, or just need some additional features sprinkled on top to make your PWA shine, these tools can help you get there.
Stay tuned for more!


Try today with a website/PWA that you are working on. Run the PWA through PWABuilder, add more capabilities to your service worker and make it publish-ready by filling up all the fields in the manifest. Try generating a test package on the Windows platform in the publish page and sideload it. When you feel your PWA is ready, try publishing it to one of the app stores.


Want to read more content from Microsoft technologists? Don't forget to follow Azure right here on

Top comments (1)