Documentation

Learn how to use Dele to quickly deploy and manage your AI-generated apps.

For Humans

1. Prepare Your App

Dele currently supports hosting pure frontend static websites (HTML, CSS, JS). Whether you use Cursor, OpenClaw, or other AI tools, ensure your project folder meets these requirements:

The root directory must contain an index.html file as the entry point.
All static resources (images, stylesheets, scripts) should be stored within this folder.
It is recommended to use relative paths (e.g., ./images/pic.png or images/pic.png) to reference resources for best compatibility.

2. Deploy App

The deployment process is very simple, just two steps:

In the drag-and-drop area on the homepage, enter a unique app name (only lowercase letters, numbers, and hyphens are supported). This name will be the exclusive URL path for your app.
Drag your entire project folder into the dashed box, or click the 'Select Folder' button to choose it.
Click 'Deploy App', and the system will automatically upload the files to the cloud and generate a preview image for your app in the background.

3. Update & Overwrite

If you have modified the code and want to update the deployed app, no complex operations are needed:

Just enter the same app name on the homepage, and then drag and drop the new folder again. The system will automatically overwrite the old files and regenerate the latest preview image in the background.

Note: For security reasons, you can only overwrite apps created by yourself.

Visibility Control

Each app has a visibility level you can change at any time from My Apps or during deployment.

Level	Icon	Behavior
Public	🌐	Visible on Explore page, anyone can access
Unlisted	🔗	Not listed on Explore, but accessible via direct URL
Password	🔑	Requires a 4-character access code (auto-generated, 0-9 a-z). Visitors see a code entry page.
Hidden	🔒	Only the owner can access. Others see an unavailable page.

Password-Protected Apps

When you set an app to Password, a 4-character code is auto-generated.
The code is shown next to the visibility icon in My Apps — you can copy or edit it.
Share the code with people you want to grant access.
Visitors enter the code once; it's saved in a cookie for 30 days.
You can change the code at any time — old codes stop working immediately.

For Agents

API

Overview

Dele provides a Deploy Skill that allows AI agents (such as OpenClaw, Cursor, or any LLM-powered agent) to programmatically deploy generated web apps via API.

The agent generates HTML/CSS/JS files → calls the Dele API → gets a live URL back. No human interaction needed.

Works with any agent that can make HTTP requests — Python, Node.js, cURL, MCP tools, etc.

Quick Install via ClawHub

Install the official Dele Deploy skill from ClawHub to let your OpenClaw agent deploy apps with one command:

Install from ClawHub →

API Key

Generate an API key from My Apps → API Keys to authenticate agent requests.

Authentication Header

Authorization: Bearer pm_xxxxxxxxxxxxxxxxxxxx

Keep your API key secret. Do not expose it in client-side code or public repositories.

Deploy Skill

The deploy skill packages local files and uploads them to Dele via the /api/upload endpoint.

Tool Definition

tool.json

{
  "name": "postme_deploy",
  "description": "Deploy a local folder or HTML file to Dele to get a live URL.",
  "parameters": {
    "type": "object",
    "properties": {
      "target_path": {
        "type": "string",
        "description": "Path to the folder or HTML file to deploy."
      },
      "app_name": {
        "type": "string",
        "description": "URL-friendly name (lowercase, numbers, hyphens)."
      },
      "app_desc": {
        "type": "string",
        "description": "Optional short description."
      },
      "visibility": {
        "type": "string",
        "enum": ["public", "unlisted", "password", "hidden"],
        "description": "App visibility. Defaults to public. If password, a 4-char code is auto-generated."
      }
    },
    "required": ["target_path", "app_name"]
  }
}

Usage

Python

from postme_deploy import execute

# Deploy a folder
result = execute(
    target_path="/tmp/workspace/my-report",
    app_name="quarterly-report",
    api_key="pm_xxxxxxxxxxxxxxxxxxxx",
    api_url="https://www.dele.fun/api/upload"
)
print(result)
# → Deployment successful! URL: https://www.dele.fun/app/quarterly-report/

cURL

# Deploy a single HTML file
curl -X POST https://www.dele.fun/api/upload \
  -H "Authorization: Bearer pm_xxxxxxxxxxxxxxxxxxxx" \
  -F "appName=my-page" \
  -F "files=@index.html" \
  -F "paths=index.html"

# Deploy multiple files
curl -X POST https://www.dele.fun/api/upload \
  -H "Authorization: Bearer pm_xxxxxxxxxxxxxxxxxxxx" \
  -F "appName=my-site" \
  -F "files=@index.html" -F "paths=index.html" \
  -F "files=@style.css" -F "paths=style.css" \
  -F "files=@script.js" -F "paths=script.js"

Node.js

const form = new FormData();
form.append("appName", "my-app");
form.append("files", fs.createReadStream("./dist/index.html"));
form.append("paths", "index.html");

const res = await fetch("https://www.dele.fun/api/upload", {
  method: "POST",
  headers: { Authorization: "Bearer pm_xxxxxxxxxxxxxxxxxxxx" },
  body: form,
});
const data = await res.json();
console.log(data.url); // → /app/my-app/

API Reference

POST/api/upload

Deploy files to create or update an app. Accepts multipart/form-data.

Field	Type	Required	Description
appName	string	Yes	URL-friendly app name
files	File[]	Yes	Files to upload (repeatable)
paths	string[]	Yes	Relative path for each file (repeatable)
appDesc	string	No	Short description (max 255 chars)

Response

200 OK

{
  "url": "/app/my-app/",
  "appName": "my-app"
}

4xx / 5xx Error

{
  "error": "Storage limit exceeded. Your Free plan allows 50MB."
}

Visibility API

POST/api/apps/visibility

Set the visibility level for an app you own. Accepts JSON body.

Field	Type	Required	Description
appName	string	Yes	Name of the app
visibility	string	Yes	`public` \| `unlisted` \| `password` \| `hidden`
accessCode	string	No	Custom 4-char code (0-9 a-z). Only for `password`. Auto-generated if omitted.

Response — password

{
  "ok": true,
  "visibility": "password",
  "accessCode": "x7k2"
}

POST/api/apps/verify-code

Verify a password-protected app's access code. On success, sets a cookie for 30-day access.

Request body

{
  "appName": "my-app",
  "code": "x7k2"
}

200 OK

{ "ok": true }

403 Forbidden

{ "ok": false }