# How "Add to Homescreen" works?

### What is a PWA?

Progressive Web Apps(PWA) use modern web capabilities to deliver an app-like user experience. They evolve from pages in browser tabs to immersive, top-level apps, maintaining the web's low friction at every moment.

**Foodomaa** is a Progressive Web Application (PWA).\ <br>

### Add to Homescreen on Chrome on Android Device

When a user loads up your website for the first time, they get a "Add to Homescreen" popup on their screen. This popup is automatically shown when the browser detects that the website is a PWA.

![](/files/-MB7xwJBfIo_FiB2Zo7t)

This automatic popup can not be shown again if it is not clicked or ignored. It is also shown only once after 10-15 seconds of user interactivity on the first load of the website.  \
\
If the user misses clicking the popup or ignores it, later then can click on the three dots button<img src="/files/-MB7yPmqlQm7pwkcTJbX" alt="" data-size="line">on the top-right corner of chrome browser and click "**Add to Homescreen**"

![](/files/-MB7xwJ9HbqTIM3iI0j-)

###

### Add to Homescreen on Safari browser on iOS device

From the Foodomaa release **v2.1.0** onwards we support custom iOS Add To Homescreen Popup message.

This can be enabled from **Admin > Settings > Customer Application > Show Custom iOS Add To Homescreen Popup**

The texts in this message can be configured from **Admin > Modules > Translations > Edit** your Language translation.

![](/files/-MD4lGEluV78McD0Fw1A)

### Why a Native iOS Popup cannot be shown?

As of July 2020, iOS does not have full support for PWAs. They still do not support major PWA functionalities like Add to Homescreen and PushAPIs.

Therefore, on an iOS device, the automatic popup for Add to Homescreen cannot be shown.

The user on an iOS device needs to click on the Share Button on Safari and then click on "Add to Homescreen".

**Here's a demo for that:**

{% embed url="<https://www.youtube.com/watch?v=I4e1aoi0P-o>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.foodomaa.com/faqs/how-add-to-homescreen-works.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
