Getting started

Quickstart

There's no signup and nothing to install — the whole deploy is one curl. You POST an HTML file to https://ship.page/deploy and get back a live URL on its own subdomain, usually in under a second.

Deploy your first drop

Take any HTML file you have lying around — a report, a prototype, a one-pager — and stream it at the endpoint:

curl -X POST https://ship.page/deploy \
-H "Content-Type: text/html" \
--data-binary @report.html

The response

A successful deploy answers with a small JSON body — the url is live the moment the response lands:

{
"slug": "vast-juice-c2dse",
"url": "https://vast-juice-c2dse.shipped.run/",
"files": ["index.html"],
"plan": "free",
"expires_at": "2026-06-17T18:00:00.000Z",
"claim_token": "spc_7xk3m9q2vj8n4p1w6z5y0r2t"
}

claim_token appears on anonymous deploys only, and exactly once — store it if you might ever claim the drop into an account later (see Drops).

What just happened

Three things worth knowing about the URL you just caught:

1. 1

   Every drop mounts at the root of its own subdomain. Absolute paths like /app.js and /styles.css resolve as-is — no base-path rewrites.

2. 2

   Slugs carry ~47 bits of entropy. URLs are unguessable, so sharing the link is the access control — viewers never log in.

3. 3

   Anonymous drops expire after 30 days — a free account stretches that to 90. Shorten that with ?ttl=, or subscribe and they never expire — see Expiry.