# About SA5's Kiosk Lib

{% hint style="warning" %}
**REQUEST FOR COMMENT ( RFC )** \
This SA5 module is currently being defined, and is open for review and comment. \
Use the left-side nav to explore the kiosk section and get an understanding of the kiosk and display mode capabilities we're considering

*Please give feedback in the* [*SA5 forum*](https://sygnal-attr.discourse.group/)*.* 
{% endhint %}

Webflow websites are typically designed for use in three contexts; 

* Desktop web browsers
* Tablets
* Mobile phones

However, there are *other usage contexts* that can be valuable as well. 

* **Kiosks** - where some or all of the site is available in a touchscreen environment, typically keyboardless, with a tablet-like touch UX.  
* **Displays** - which present content from the website, using screens, scrolling, audio, and video to both entertain the viewer and inform them about current specials, products, and services. 

{% hint style="info" %}
For *kiosks*, the *display* context combines exceptionally well as a special, automatic mode.  When the kiosk is not in use, we can ideally switch to a display mode to engage users and inform them of new products and services, while preventing screen burn-in. 
{% endhint %}

## Why SA5 Kiosk Exists 

The purpose of this library is to centralize tooling and best practices that make it easy to create these setups from a Webflow-hosted site;

* Normal public site, with;
  * Kiosk features, including kiosk-only pages and page-variants ( like an ECom Product page )  
  * Display features, including content playlists  
* Kiosk-only site, designed specifically for kiosk use
* Display-only site, designed specifically for hands-free content display 
* Hybrid sites including all three modes 

### Features 

Here are the core capabilities;  

* Kiosk mode
  * Kiosk mode detection 
  * Desktop v. Kiosk-mode conditional visibility 
* User activity and in-activity detection  
  * Mode-switching
    * Kiosk inactivity resets to the kiosk homepage, or switches to Display mode 
    * Kiosk activity leaves display mode and returns to kiosk mode

### Future

The **Display mode** concept has quickly gained value as a worthwhile direction to consider, so plans are to embrace it as an alternative mode in this library as well. 

## Use Cases

Here are some examples of Kiosk and Display mode for a Webflow site being used in real world situations.  

|                                                           | Display                                                                                  | Kiosk                                                                                         |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Real estate                                               | Window display showing current property listings from the website.                       | In-reception kiosk for browsing and searching available properties and booking showing times. |
| Restaurant                                                | Window display, or at couter display show food, cooking videos, menu items and specials. | Ordering                                                                                      |
| Dental office                                             | Showcase treatments and self care. Educate, and get questions about                      | Interactive learning about specialized treatments a client might be interested in.            |
| Tattoo parlor, hair salon, makeup salon ( lashes, nails ) | Showcase designs. Educate clients on options.                                            | Browse catalog                                                                                |
| SPCA                                                      | Pets for adoption                                                                        | Browse pets for adoption, ven across centers                                                  |
| Retail shop                                               | Specials, new products, featured products, commercials                                   | Ordering products, browsing products, searching products                                      |

## Kiosks

* Kiosks - where some or all of the site is available in a touchscreen environment, typically keyboardless, with a tablet-like touch UX.  Used in a retail outlet or waiting room
* Displays - which present content, and change it 
* Hybrid - a kiosk which, when not in use, falls into a display mode state 

And Still others

* Watch


---

# 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://attr.sygnal.com/sa5-kiosk/about.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.