# Setup

## Prerequisites

* Essential Kit imported into the project from My Assets section of Package Manager.
* Icon assets prepared as Texture2D (PNG recommended) for your shortcuts.
* iOS builds support up to 4 shortcuts; Android varies by device launcher.

## Setup Checklist

1. Open **Essential Kit Settings** (`Window > Voxel Busters > Essential Kit > Open Settings`), switch to the **Services** tab, and enable **App Shortcuts**.
2. Add your shortcut icons to the **Icons** list. These textures will be referenced by filename when creating shortcuts.
3. Changes to the settings asset are saved automatically. If you use source control, commit the updated `Resources/EssentialKitSettings.asset` file.

### Configuration Reference

| Setting              | Platform | Required? | Notes                                                                                                         |
| -------------------- | -------- | --------- | ------------------------------------------------------------------------------------------------------------- |
| Enable App Shortcuts | All      | Yes       | Toggles the feature in builds; disabling strips related native code.                                          |
| Icons                | All      | Optional  | List of Texture2D assets referenced by filename in `SetIconFileName()`. Icons not in this list won't display. |

{% hint style="info" %}
Need a working baseline? Run the sample at `Assets/Plugins/VoxelBusters/EssentialKit/Examples/Scenes/AppShortcutsDemo.unity` to confirm your settings before wiring the feature into production screens.
{% endhint %}

## Platform Notes

### iOS

* Maximum of 4 shortcuts displayed via 3D Touch or long-press on devices running iOS 9+.
* Icons should be square (recommended 35x35 pt for single-scale images).

### Android

* Shortcuts supported on Android 7.1 (API level 25) and above.
* Different launchers may display shortcuts differently; test on target devices.
* Icons automatically adapt to device launcher theming.


---

# 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://assetstore.essentialkit.voxelbusters.com/features/app-shortcuts/setup.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.