Command Line
Drop from your terminal
Coming soonThe Droploft CLI is planned for the moment after your AI tool finishes generating HTML. One command, one link, from piped stdin, CI/CD pipelines, and local file drops.
droploft push
Coming soon: zero-config drops from pipes, files, and folders.
Anonymous first useFirst
droploft push is planned to work without login. 15 uploads/day on the anonymous tier.Pipe from stdin
claude --output html "Q1 report" | droploft push - — drop straight from your AI tool.CI/CD readyPlanned for GitHub Actions, post-build hooks, and JSON output mode for scripting.
DistributionPlanned distribution through npm, Homebrew, standalone binary, and
npx droploft.Waitlist
terminal
# Coming soon
$ droploft push q1-report.html
Optimizing..... 342 KB → 98 KB
Auto TOC ...... 5 sections
OG card ....... ready
✓ Dropped in 4.2s
→ https://droploft.ai/d/a3x9k2
# Pipe from AI tool
$ claude --output html "Q2 forecast" \
| droploft push -
CI/CD
Ship from your repo
Coming soonGitHub Actions support is coming soon: drop on every push, preview every pull request, or regenerate on a schedule from a single workflow step.
droploft/publish-action
Planned GitHub Actions support for files and globs, with the Droploft URL returned as an output variable you can chain.
Outputs the URLChain
steps.droploft.outputs.url into PR comments, Slack notifications, or deployment status checks when the action ships.Stable slugsPass
slugto keep the same URL across commits — auto-changelog will track every revision.Batch uploadsUse glob patterns (
reports/**/*.html) and the action will auto-create a Collection.Or just use the CLIPrefer
npx droploft push? It will work identically. No action dependency.Waitlist
.github/workflows/drop.yml
name: Drop to Droploft
on:
push:
branches: [main]
paths: ['reports/**.html']
jobs:
drop:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: droploft/publish-action@v1
id: droploft
with:
api-key: ${{ secrets.DROPLOFT_API_KEY }}
file: reports/q1-growth.html
slug: q1-growth
collection: quarterly
- run: echo "Dropped: ${{ steps.droploft.outputs.url }}"
REST API
Build on top of Droploft
Use the API when you need Droploft inside your own product, scripts, or internal tools.
Open API documentation
Request and response shapes, authentication, error codes, pagination, webhooks, and SDK notes.
Webhooks
Subscribe to events
Get notified when something happens. Useful for triggering workflows, piping analytics to your data warehouse, or firing Slack alerts when someone reads your proposal.
9 event types
HMAC-SHA256 signed, retry on 5xx, delivered in order per endpoint.
document.publishedA new document was published
document.viewedFirst view by a unique visitor
comment.created / comment.resolvedThreaded comment lifecycle
version.created / fork.createdVersion bumps and forks
POST https://your-server.com/hook
// headers
X-Droploft-Event: document.viewed
X-Droploft-Signature: sha256=a7f...
// body
{
"event": "document.viewed",
"document_id": "a3x9k2",
"visitor_id": "anon_f7d...",
"source": "slack",
"timestamp": "2026-04-11T..."
}
Reference
Deep dives
Complete specifications for every surface.
CLI docsComing soon
Full command reference, flags, config file format, CI/CD examples
REST API reference
Every endpoint with request/response examples, error codes, pagination
Browser ExtensionComing soon
One-click drop from Claude, ChatGPT, v0. Batch capture with AI source metadata
Manage API keys
Create account-level or document-level keys. Scoped permissions, revocation