Deplixo API — Deploy Guide
No authentication required. No account needed. Just POST and get a live URL.
## Deploy (single file)
curl -X POST https://deplixo.com/api/v1/deploy \
-H "Content-Type: application/json" \
-d '{"code": "
\";"
},
"title": "My Multi-file App"
}'
## Response
{"hash_id": "abcd-efgh", "url": "https://deplixo.com/abcd-efgh/", "title": "My App", "claim_token": "...", "claim_url": "..."}
Files are served at their paths: deplixo.com/abcd-efgh/style.css, deplixo.com/abcd-efgh/app.js, etc.
## React / Vue / Svelte
Use CDN imports — do NOT use npm, Vite, or build tools. Example for React:
## Storage
Apps automatically get persistent storage:
- localStorage works normally AND is persisted to server (survives across sessions/devices)
- window.deplixo.db.set(key, value) / .get(key) / .delete(key) / .list(prefix) for explicit key-value storage
- window.deplixo.db.getEntry(key) — returns { value, author: { id, name } | null }
- window.deplixo.db.onChange(callback) — real-time sync across all connected clients
## Multi-User Identity
Apps are automatically multi-user. On first write, visitors pick a display name (no account needed).
- window.deplixo.user — { id, name } for the current visitor
- Author info is attached to every write and available via getEntry()
## Request Schema
POST /api/v1/deploy
{
"code": "string (HTML for single-file apps)",
"files": {"path": "content", ...} (for multi-file apps — must include index.html),
"title": "string (optional)",
"slug": "string (optional, requires account)",
"remixed_from": "string (optional, hash_id of parent app)",
"app_id": "string (optional, hash_id of existing app to update)",
"claim_token": "string (required when updating an unclaimed app via app_id)"
}
One of "code" or "files" is required. Max total size: 1MB.
## Iterative Development (Update Existing App)
To update an app instead of creating a new one, include app_id and claim_token from a previous deploy:
curl -X POST https://deplixo.com/api/v1/deploy \
-H "Content-Type: application/json" \
-d '{"code": "
Updated!
", "title": "My App v2", "app_id": "abcd-efgh", "claim_token": "..."}'
The response includes "updated": true when an existing app is modified. The URL stays the same.
## Other Endpoints
GET /api/v1/apps/{app_id} — get app info (public, accepts abcd-efgh or abcdefgh)
GET /api/v1/apps/{app_id}/source — get app source code (public)
## Claiming Apps
The claim_url returned from deploy lets users claim ownership via the web UI.
Visiting the URL while logged in allows one-click claiming. A subscription ($3/mo+) keeps apps alive permanently.