@shippieapp/cli
v0.1.1
Published
Build and deploy private local Shippie apps from your terminal.
Maintainers
Readme
@shippieapp/cli
Build and deploy private, local Shippie apps from your terminal — and drop an app to get an unlisted live link in seconds.
A drop returns an unlisted link (anyone with the link can open it). Trial drops stay live for 24 hours unless you claim them. Saved data stays on the device that opened the app — drops don't add a backend or cross-device sync.
Quickstart
# Run without installing
npx @shippieapp/cli drop ./my-app --title "My App"
# …or install the `shippie` command
npm install -g @shippieapp/cli
shippie drop ./my-app --title "My App"Drops are anonymous — no sign-in needed to go live.
Drop an app
# A folder, .zip, or .html file
shippie drop ./my-app --title "My App"
# A single generated HTML document
shippie drop --title "Tiny Counter" \
--html '<!doctype html><button id=b>+1</button><output id=n>0</output><script>let x=+(localStorage.x||0);n.textContent=x;b.onclick=()=>{localStorage.x=++x;n.textContent=x}</script>'
# A generated files map (JSON: path → text)
shippie drop --title "Inventory" \
--files '{"index.html":"<!doctype html><h1>Inventory</h1><script src=\"app.js\"></script>","app.js":"localStorage.setItem(\"ready\",\"1\")"}'Output:
My App
Unlisted link: https://shippie.app/trial-abc123
Live & unlisted — anyone with the link can open it.
Expires: 2026-06-25T12:00:00Z
Claim to keep: https://shippie.app/auth/login?return_to=…
Live for 24h — claim to keep it.
Saved data stays on this device.More commands
Run shippie --help. Sign in with shippie login to claim drops and manage apps
(deploy, apps, status, visibility, rollback, …) under an account.
Docs
Full Send-To-Drops guide (incl. MCP setup): see docs/mcp-cli-drop.md in the
Shippie repo. The MCP twin of drop
is @shippieapp/mcp.
MIT licensed.
