# WPA - Web App Applications

## Purpose of the PWA features

* **Enhanced User Experience**: By enabling PWA, merchants can provide a more app-like experience for their customers, which can increase engagement and usability.
* **Offline Capabilities**: PWAs often include features that allow users to interact with the store even when they have limited or no internet connectivity, making it more accessible.
* **Push Notifications**: PWAs can integrate push notifications, allowing stores to send updates directly to customers' devices, enhancing marketing reach.

For a deeper understanding, you can explore this article: [What are PWAs?](https://web.dev/articles/what-are-pwas).

## Here's how to set up your PWA in the settings for a smoother experience.&#x20;

* **Enable/Disable PWA**: This allows the user to enable or disable the Progressive Web App functionality for their store. Enabling PWA makes the store installable as an app directly from web browsers like **Chrome and Edge**.
* **App Name**: The name that will appear when users install the app on their device. This should be a recognizable name that aligns with the store's branding.
* **App Description**: A short description that provides an overview of the app's purpose or features. This helps users understand what the app is about before installation.
* **Primary Color**: Users can select the primary color of the PWA, which will define the theme color of the installed app, affecting how it appears on a device’s home screen and in the browser.

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2FBxTfOiQlmt0JN16lihic%2Fimage.png?alt=media&#x26;token=3a4d6bee-845e-498f-acac-b88c8300dbc7" alt=""><figcaption></figcaption></figure>

## How can your customers install your web app on their browser or directly on their phone?

### Install on Chrome browser&#x20;

1. When customers are on your store page, they will see a download icon in the browser's address bar, as shown in the screenshot. By clicking this icon, they can install your Progressive Web App (PWA) directly on their device.

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2Feb1yWyO2qE4w8FcsMyCh%2Fimage.png?alt=media&#x26;token=4b029ee6-8cde-45af-9e21-5ebccabc70c0" alt=""><figcaption></figcaption></figure>

2. Click in the **Install app icon** -> Then click "**Install**"&#x20;

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2F9N5H8HHvslRwHXByM1XG%2Fimage.png?alt=media&#x26;token=57676919-5a72-47a2-85f8-2cd2a138189b" alt=""><figcaption><p>Install app from customers' browsers</p></figcaption></figure>

3. The app will appear in your computer's Chrome apps section, labeled with your store's name. Once installed, it will be accessible like a native app on your device. Users will continue receiving notifications from your store directly through this app.

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2F3crkwDywnOXcLo4tKdUL%2Fimage.png?alt=media&#x26;token=84e22f36-9ace-468f-b142-ce9d52c78a71" alt=""><figcaption><p>The app downloaded on your device</p></figcaption></figure>

4. Here’s how your PWA will look. Customers can still receive notifications from your store through the app.

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2FmtMnucoZZlxriYp9eLqx%2Fimage.png?alt=media&#x26;token=fc2b7159-d76d-472c-b40c-5998e58b226c" alt=""><figcaption></figcaption></figure>

## &#x20;Install on customers' smartphone

1. When using Safari on an iPhone, customers can tap the share icon at the bottom of the screen and choose "**Add to Home Screen**" to install the app on their device.&#x20;

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2F3x1tAdhChT9YHn4SvU4q%2Fimage.png?alt=media&#x26;token=2bcdf232-d555-40e1-93ba-fbbd42424823" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2FFouBsaPLBGsQUMiAnuCu%2Fimage.png?alt=media&#x26;token=b4d28ef1-b4ba-4d79-b15a-b431ff45f3cd" alt=""><figcaption><p>Add to Home Screen</p></figcaption></figure>

2. Customers can edit the app name as they wish, then click "Add"

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2FFNsdCH930RBfAz25TbAo%2Fimage.png?alt=media&#x26;token=668e1684-31b5-4c04-9c00-1e9319e5dc7b" alt=""><figcaption></figcaption></figure>

The app is now displayed on your home screen, functioning just like a native app on your phone.

<figure><img src="https://2478559309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fp0EbXtq6T4WMCO5OtRHB%2Fuploads%2FTmQLTVM2sOMKWwdBwobL%2Fimage.png?alt=media&#x26;token=22077891-d10c-4af6-bc47-53de343afdd1" alt=""><figcaption></figcaption></figure>
