# Application Information

For a Progressive Web App (PWA) to be installable, the manifest file must include certain mandatory information. These details help the browser understand how the application should be presented to the user and its behavior upon installation.

While not all of these properties are strictly mandatory, a manifest must at least contain the minimum information for the browser to prompt the user to install the application. In practice, it is recommended to include as much information as possible to enhance the user experience.

Here are the key properties of the manifest that are typically considered necessary for PWA installation:

1. **`name`:** The name of the application.
2. **`short_name`:** A short or abbreviated name for the application (used when space is limited, e.g., on a home screen).
3. **`start_url`:** The relative or absolute URL from which the application should launch when opened.
4. **`display`:** Determines how the application should be displayed. Common values include `fullscreen`, `standalone`,`minimal-ui` and `browser`.
5. **`background_color`:** The background color of the application.
6. **`theme_color`:** The color representing the main theme of the application.
7. **`icons`:** An array of objects describing the application's icons for different sizes and resolutions. ([see after](/1.0.x/the-manifest/icons.md))

Minimal example of a manifest:

{% code title="/config/packages/pwa.yaml" lineNumbers="true" %}

```yaml
pwa:
    manifest:
        enabled: true
        name: "My PWA"
        short_name: "PWA"
        start_url: "/index.html"
        display: "standalone"
        background_color: "#ffffff"
        theme_color: "#4285f4"
```

{% endcode %}

{% hint style="info" %}
As it has an impact on the Twig pages, you may need to clear the cache when the manifest is enabled.
{% endhint %}


---

# 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://pwa.spomky-labs.com/1.0.x/the-manifest/application-information.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.