--- myst: html_meta: "description lang=en": "How to launch Kasm Workspaces as a Progressive Web App on all platforms." "keywords": "Kasm, Workspaces, Desktop, Fat Client, PWA, Progressive Web App" "property=og:locale": "en_US" --- ```{title} Progressive Web App (PWA) ``` # Progressive Web App (PWA) Welcome to the Kasm Workspaces Progressive Web App (PWA)! A PWA provides a similar experience to that of a mobile app installed from an App Store, with some key benefits for users: **Benefits for the user:** * **Small size** - You aren't installing a full application, which saves storage space on your device. * **Instant updates** - The PWA is still a website, so updates to the site are immediately available to the PWA. * **Add to homescreen** - You can add the PWA to your homescreen, making it easily accessible like any other application. * **Tables window** - Enjoy a clutter-free experience without the distraction of browser bars, maximizing the useful space available. ## Installation PWA installation methods vary across platforms and even devices within platforms. Unfortunately PWA installation isn't universal across platforms or even devices on platforms. Some platforms prompt you to install the app when you visit a site that has PWA functionality, some just show it in the browser bar, and some don't show anything at all (iOS). Here are the installation instructions for different platforms: ### Android Using Chrome on Android tends to give the best PWA experience, When using Chrome on Android, you will be prompted to install the PWA when you visit the site. For Firefox, click on the three dots next to the browser bar and select "Install App." This also works with Chrome if you close the prompt and decide to install it later. ```{figure} /images/user_guide/android.webp :align: center **Installing on Android** ``` ### iOS Unfortunately, iOS does not provide a direct indication that a PWA is available. You can only install a PWA using Safari on iOS by following these steps: 1. Open Safari and navigate to the site. 2. Tap the Share icon. 3. Scroll down until you find the option "Add to Home Screen" and tap on it. 4. Finally, tap the "Add" button to install the PWA. ```{figure} /images/user_guide/ios.webp :align: center **Installing on iOS** ``` ### Desktop Browsers Currently, Safari on MacOS does not offer an option to install a PWA. However, other browsers support PWA installation: Most desktop browsers show the option to install the PWA either in the browser URL bar or when you click the three dots menu. ```{figure} /images/user_guide/macos_chrome.webp :align: center **Installing on Desktops** ``` ## Removing Removing a PWA can vary on Android, iOS, and desktop platforms. Here are the steps to remove the PWA from each platform: ### Android Android doesn't have a universal system for removing PWAs, as it can vary based on the phone, launcher, browser, or even the specific version of the browser. Here are three different options you can try: 1. From your app drawer or home screen, open **Settings**. 2. Tap **Apps & notifications** and then select **See all apps**. 3. Find the PWA that you want to remove and tap the icon. 4. Tap **Uninstall**. --- Alternatively: 1. Find the app on your homescreen. 2. Long press until extra information pops up. 3. Click on the Remove icon --- Or: 1. Find the app on your homescreen. 2. Long press until extra information pops up. 3. Start dragging until an option to remove appears. 4. Drop the app into the Remove area. ```{figure} /images/user_guide/android_uninstall.webp :align: center **Uninstalling on Android** ``` ### iOS Removing a PWA on iOS can be done by following these steps: 1. Find the app on your home screen 2. Either long press on the background until the icons start wiggling and a minus icon appears in the top left corner on the apps, then click the minus icon, or long press on the app and click the **Delete Bookmark** option. 3. Confirm you want to delete the bookmark. ```{figure} /images/user_guide/ios_uninstall.webp :align: center **Uninstalling on iOS** ``` ### Desktop 1. Open the Workspaces PWA. 2. At the top of the application find the three dots menu at the top right and click it. 3. Click the **Uninstall** option. 4. Click on the subsequent **Remove** button. ```{figure} /images/user_guide/macos_uninstall.webp :align: center **Uninstalling on Desktops** ```