> For the complete documentation index, see [llms.txt](https://docs.zep.us/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zep.us/zep-script/zep-script-guide/zep-script-development-guide/zep-script-deployment-guide.md).

# ZEP Script Deployment Guide

## STEP 1

Select all of the files to be used, including the **main.js** file developed with ZEP Script, image files, and widget files, and compress them.

{% hint style="danger" %}
Note:

* The app’s file name and type must be set as “**main.js**”.
* **Select the individual files together** to compress. Do not compress a folder.
* The supported filename extension is \***.zip**.
  {% endhint %}

![](/files/XSgCr43sg6j1jEEytFrW)

{% file src="/files/xIP0lpNQrmPxD4Y2wHCU" %}

## STEP 2

Create an account on ZEP and sign in, on the [**My Spaces**](https://zep.us/spaces/me) page click **Your Profile Name** > [**My apps (Beta)**](https://zep.us/me/apps).

<div align="left"><figure><img src="/files/XJAycfQPoitDEl968keK" alt=""><figcaption></figcaption></figure></div>

## STEP 3

3\) Click **Upload app** on the [**My apps (Beta)**](https://zep.us/me/apps) page.

<div align="left"><figure><img src="/files/6iAdtLYaAKxv4oHIMIxl" alt=""><figcaption></figcaption></figure></div>

## STEP 4

Click the **Upload** button after filling out the **App name**, **Description**, selecting the app **Type**, and uploading the **Icon**, and compressed **ZEP script file**.

<div align="left"><figure><img src="/files/Af2zSv6ZG6a76Z0HzS7c" alt=""><figcaption></figcaption></figure></div>

<div align="center"><figure><img src="/files/Sg7JxlyF62odwc1qbxXn" alt=""><figcaption><p>This is how the app name and icon appear. (Mini-Game)</p></figcaption></figure></div>

## STEP 5

You can install apps to your desired maps according to their App Type.

* **Normal App:**

  Enter **Map Editor** on a map for which you have an Editor role or higher and in the **Map manager** in the bottom left corner click ⚙️ > **Edit** to bring up the **Map Setting** pop-up and select your App from the Application drop-down menu.

<div align="left"><figure><img src="/files/wEUi6yyKBHronA1pI7s2" alt=""><figcaption></figcaption></figure> <figure><img src="/files/bRxDNr3COFQPmr23p5HX" alt=""><figcaption></figcaption></figure></div>

* **Mini-Game:**

  Enter the play screen > Select the **Mini-Game** button on the side bar.

<div align="left"><figure><img src="/files/LLDNTqoNnAYTguWKcnVW" alt=""><figcaption></figcaption></figure></div>

## 🚧 Debugging and Error Messages

When the app is executed, error messages will be displayed in <mark style="color:red;">red text</mark> in the chat message box for all who have permission settings of Staff or higher.

<div align="left"><figure><img src="/files/oby05Shz7hLLqMkSuIOB" alt=""><figcaption></figcaption></figure></div>