Skip to main content

How to use Progressive Web Apps (PWA)

Share a web-based version of your app that users can open instantly in their browser—no app store download required.

S
Written by Support
Updated this week

A Progressive Web App (PWA) is a browser-based version of your app that works on mobile and desktop devices. It lets users access your app through a URL, bookmark it, and even add it to their home screen. PWAs are useful for quick access, previews, and sharing, though they do not replace native app store builds.

How to use Progressive Web Apps (PWA)

  1. Log in, go to Builder in the left navigation

  2. Go to App Settings, then open Share App

  3. Copy the HTML5 URL

    • This URL opens the web-based version of your app in a browser

    • You can share this link directly with users

  4. (Optional) Set up a custom domain for your PWA

    • Go to App Settings

      1. Click the Progressive Web Apps tab

      2. Enter the custom domain you want to use (for example, app.yourdomain.com)

      3. Click Save

    • Configure your DNS settings for the custom domain

      1. Open your domain provider’s DNS manager

      2. Add a new record:

        1. Type: CNAME

        2. Host: the subdomain you created (for example, app)

        3. Value: pwa.appdocumentation.com

        4. TTL: 1–4 hours

        5. Save the record

  5. (Optional) Add an SSL certificate

    • In Progressive Web Apps settings, choose one of the following:

      1. Upload your own SSL certificates

      2. Proceed without SSL (not recommended)

  6. Update PWA meta tags

    • Add a description to explain what your app does

    • Review the default title (pulled from your app name)

    • Configure social sharing metadata:

      1. Description text

      2. Default image (usually your app logo)

    • These values are used when your app is shared on Google, Facebook, WhatsApp, X, and other platforms

  7. Access your PWA

    • Open your custom domain (or HTML5 URL) in a browser

    • Your app loads as a web-based experience

  8. Add the PWA to a device home screen

    • On iOS:

      1. Open the PWA in Safari or Chrome

      2. Tap Share

      3. Select Add to Home Screen

      4. Name the shortcut and tap Add

      5. The PWA appears as an icon on the device home screen

  • On Android:

    1. Open the PWA in Chrome

    2. Tap 3 dots icon

    3. Select Add to home screen

    4. Name the shortcut and tap Add

    5. On some models, you will be prompted to touch and hold to place the app icon manually, or tap Add automatically to place it on your screen automatically.

Pro tips

  • Use PWAs for previews, internal testing, or easy sharing without app store friction

  • Set up a custom domain to avoid exposing your app ID and improve branding

  • Always use SSL for better security and browser compatibility

  • PWAs have limitations compared to native apps, especially around WebViews and advanced device features

  • For the best user experience, publish native iOS and Android apps alongside your PWA

Did this answer your question?