@buddy-works/drop

Deploy a folder (or .zip) of static files to a live URL with Buddy Drop - no account needed.

npx @buddy-works/drop ./dist --domain my-site.buddy.site
npx @buddy-works/drop ./site.zip --domain my-site.buddy.site

A .zip is unpacked locally before upload - a single top-level folder inside it is flattened away, so a zipped site folder publishes its content at the domain root, exactly like dropping the folder on buddy.works/drop.

The site goes live at https://my-site.buddy.site in about a minute and stays up for 1 hour. The command also prints a claim URL - open it, sign up for a free Buddy account, and the site is yours permanently: the address is kept and the site moves into your own Buddy workspace as a git repository with a configured pipeline, so from then on every git push redeploys it.

Treat the claim URL as sensitive - it expires after 60 minutes and transfers ownership to whoever opens it.

Commands

npx @buddy-works/drop <dir|site.zip> --domain <name.zone>   # deploy at a full address
npx @buddy-works/drop <dir|site.zip> --name <name>          # deploy, first free zone
npx @buddy-works/drop domains <name>                        # zone availability for a name
npx @buddy-works/drop zones                                 # list the free zones

Options

| Flag | Meaning | | --- | --- | | --domain <name.zone> | Full address to publish at, e.g. my-site.buddy.site. | | --name <name> | Subdomain only - the first free zone is picked (or pair with --zone). | | --region <id> | us, eu or asia. Default: detected from the system time zone. | | --json | Machine-readable output (final URLs as one JSON object), no progress lines. | | --api <base> | API base override for one command. |

The API base defaults to https://buddy.works/drop/api; set the BUDDY_DROP_API environment variable to point every command at another Drop deployment (stage, local dev) - --api still wins for a single command.

Limits

Up to 50 files and 100 MB per drop; static files only. The directory should contain an index.html at its root - without one, visitors see a file listing instead of a page.

For AI agents: https://buddy.works/drop/llms.txt