# Creating a Configuration

## User Guide: Enterprise Launcher Tab <a href="#user-guide-enterprise-launcher-tab" id="user-guide-enterprise-launcher-tab"></a>

### Overview <a href="#overview" id="overview"></a>

The Enterprise Launcher tab is where to go to manage the home screen for rugged devices, specifically for use in a shared device model. Here the user will be able to edit or delete their Launcher configurations, download a configuration to the devices by scanning the QR Code, and send notifications to devices.

### Creating A Configuration <a href="#creating-a-configuration" id="creating-a-configuration"></a>

***BEST PRACTICE TIPS*** **:** Multiple configurations can be created for the organization. These configurations can be edited either on the BlueFletch Portal, on an IDE, or in a text editor. If configurations are built within an IDE or text editor, copy and paste the configs into the raw config editor on the Portal and be sure to update configuration versions and include descriptions for updates.

1. Navigate to Enterprise Launcher and select Configurations. Click ***NEW CONFIGURATION*** in the top right corner.&#x20;

<figure><img src="/files/erbta8xA8rBXZbVdCanX" alt="" width="563"><figcaption></figcaption></figure>

2. Enter a name and description for the configuration. Edit the body of the configuration using the menu provided, and click ***SAVE***.&#x20;

<figure><img src="/files/qCHC3wHDBG4G5Mmk125W" alt="" width="563"><figcaption></figcaption></figure>

### Viewing the Raw Configuration <a href="#viewing-the-raw-configuration" id="viewing-the-raw-configuration"></a>

The raw configuration file can be viewed at any time during the configuration process by clicking ***VIEW RAW CONFIG*** at the bottom of the window. The configuration can be edited in this mode or you can return to the guided editing window by clicking ***HIDE RAW CONFIG***.&#x20;

<figure><img src="/files/Xo7kJCrHcg0FSDSeJDTc" alt="" width="563"><figcaption></figcaption></figure>

### Customizable Sections <a href="#customizable-sections" id="customizable-sections"></a>

More information about any of the fields within any tab can be viewed in the [Launcher Configuration Documentation](/bluefletch-enterprise/product-guides/bluefletch-launcher/launcher3/technical-guide.md).

#### General <a href="#general" id="general"></a>

The General tab is where the config version and license can be specified for this specific configuration.&#x20;

<figure><img src="/files/Rjl5zA28NOXOePyaaATS" alt="" width="512"><figcaption></figcaption></figure>

#### Settings <a href="#settings" id="settings"></a>

The Settings tab is used to configure key values that control various processes of the device.&#x20;

<figure><img src="/files/JZ0GqokqChvOoao97aJE" alt="" width="563"><figcaption></figcaption></figure>

#### Layouts <a href="#layouts" id="layouts"></a>

The Layouts tab is used to specify which applications, folders and shortcuts are viewed based upon which user is logged in. Within each type of user, specifications for which apps are available can be set. Applications, folders and shortcuts can be created by clicking either ***ADD APPLICATION***, ***ADD SHORTCUT***, or ***ADD FOLDER***. Once a folder is created, applications can be placed inside of it by editing the folder and clicking ***ADD APPLICATION***.&#x20;

<figure><img src="/files/IEPEpKtWKXRqX2QMG0JM" alt="" width="563"><figcaption></figcaption></figure>

#### Group Inclusion <a href="#group-inclusion" id="group-inclusion"></a>

The Group Inclusion tab is where an admin can control which applications the logged in user has access to. Each type of user's collection of applications can be toggled by selecting the boxes beneath that type of user. Group names can be changed by clicking the ***EDIT NAME*** button next to each group. A Group can be removed by clicking ***DELETE*** at the bottom of any specific group.&#x20;

<figure><img src="/files/LImBPdI0VpCdxxt067Ll" alt="" width="563"><figcaption></figcaption></figure>

#### Intents <a href="#intents" id="intents"></a>

The Intents tab allows the admin to specify custom intents that are set to fire at different points in device usage. Intents can be set to fire at *login*, *logout*, *boot*, *uncradle*, *cradle*, and *screen on*. An intent can be added to a device event by clicking ***ADD CUSTOM INTENT*** and can be removed by clicking ***REMOVE*** located at the bottom of any intent.&#x20;

<figure><img src="/files/VOEYlAnyzxeasMD3Kpvc" alt="" width="319"><figcaption></figcaption></figure>

#### Themes <a href="#themes" id="themes"></a>

The Themes tab allows the admin to set themes for the device such as the logo, theme colors, and wallpaper.&#x20;

<figure><img src="/files/hlONZaxki0ZQteJScsOq" alt="" width="510"><figcaption></figcaption></figure>

#### Authorization <a href="#authorization" id="authorization"></a>

The Authorization tab allows the admin to specify which means of authorization the device will use. More information about authorization can be found in the [Authorization Documentation](/bluefletch-enterprise/product-guides/authentication-and-sso/technical-guide.md).

<figure><img src="/files/q0muvrAjkhmrWseiRQqU" alt="" width="515"><figcaption></figcaption></figure>

#### Support <a href="#support" id="support"></a>

The Support tab allows the admin to specify various values of the Support Tool. These values give the admin more control over the device being used such as alarm setting for low storage, alarm settings for low battery, and find me events.&#x20;

<figure><img src="/files/f22xcRqYbVu9kB5BgVlm" alt="" width="518"><figcaption></figcaption></figure>

#### Patterns <a href="#patterns" id="patterns"></a>

The Patterns tab allows the admin to specify configurations for associating search text with applications. If the search text matches the configured regex pattern, the application specified will be displayed, and could also specify the intent and extras that will be passed to the app when the search result is tapped. A pattern can be added by clicking ***ADD PATTERN*** located at the bottom of the page. A pattern can be removed by clicking ***REMOVE*** located at the bottom of any pattern card.&#x20;

<figure><img src="/files/yiSjDyUNQmczPCLeHEnI" alt="" width="488"><figcaption></figcaption></figure>

#### Keyboard <a href="#keyboard" id="keyboard"></a>

The Keyboard tab allows the admin to set certain specifications regarding the device keyboard. These include haptic feedback, big button text, keyboard layout, and key previews. For examples of all keyboard settings view the [Keyboard Documentation](/bluefletch-enterprise/product-guides/device-applications/keyboard/technical-guide.md).&#x20;

<figure><img src="/files/IdZdGWcafsDNHz5tWVtv" alt="" width="527"><figcaption></figcaption></figure>

#### Browser <a href="#browser" id="browser"></a>

The Browser tab allows the admin to set specifications regarding the device browser, such as show url, show title, allow cookie preview, and browser orientation.&#x20;

<figure><img src="/files/fF3jluN7EAGmSUJ18wY7" alt="" width="499"><figcaption></figcaption></figure>

#### Additional <a href="#additional" id="additional"></a>

The Additional tab allows the admin to specify certain package to disable within the device, any extended attributes to include, and notification broker info.

**Disable Packages**

The Disable Packages section allows the admin to specify certain packages to be disabled in the device by entering the names of packages. A package to disable can be added by clicking ***ADD FIELD*** and can be removed by clicking the minus button located to the right of any included package.&#x20;

<figure><img src="/files/5XeN8IMKWWy26Qmiqymr" alt="" width="563"><figcaption></figcaption></figure>

**Extended Attributes**

The Extended Attributes sections can be used to specify key-value pairs that customers can use to provide additional custom settings. An extended attribute can be added by clicking ***ADD EXTENDED ATTRIBUTE*** and can be removed by clicking ***REMOVE***.&#x20;

<figure><img src="/files/oT4zWhOFwzqDy9ew4Ot9" alt="" width="539"><figcaption></figcaption></figure>

**Notifications**

The Notifications section can be used to specify Broker objects to connect to the messaging application in the device. During Launcher boot process, Launcher will communicate with the Messaging application to start. Then, it will register the MQTT Brokers, per configuration values. If "Enable Notifications Always On" is true, the MQTT Broker will be connected. A Broker object can be added by clicking ***ADD BROKER OBJECT*** and can be removed by clicking ***REMOVE*** located at the bottom of any Broker object card.&#x20;

<figure><img src="/files/Dr5cUdE1XI8CisCzBshK" alt="" width="563"><figcaption></figcaption></figure>

**Secure Notifications**

The Secure Notifications feature is a custom notification tray to be used as a replacement for the default Android System notification tray. This feature will allow device administrators to lock-down the notifications display and give them the ability to control which notifications are presented to the user. The "Whitelist" and "Blacklist" fields contain a list of packages to either suppress from display notifications or allow them to display notifications. A package can be added to either list by clicking ***ADD PACKAGE TO BLACKLIST*** or ***ADD PACKAGE TO WHITELIST***. A package can be deleted by clicking the delete icon located to the right of any package.

<figure><img src="/files/MeBDPOalBIn1aH6EsXzC" alt="" width="563"><figcaption></figcaption></figure>


---

# 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.bluefletch.com/bluefletch-enterprise/product-guides/portal/enterprise-launcher/creating-a-configuration.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.