# 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>


---

# 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.zep.us/zep-script/zep-script-guide/zep-script-development-guide/zep-script-deployment-guide.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.