QuickDrop CLI Documentation

Installation

Quick Install

curl -s https://quickdrop.host/install/ | bash

Installs QuickDrop CLI directly from our servers. Only requires curl.

Commands

Login

$ quickdrop login

Log in to your QuickDrop account. You'll be prompted for your username and password.

  • Access tokens valid for 30 minutes
  • Refresh tokens valid for 24 hours

Push

$ quickdrop push index.html

Deploy an HTML file to QuickDrop. Supports both single files and files with external CSS/JS.

Features:

  • Automatically bundles CSS and JS files
  • Supports nested directories
  • Maintains same URL for file updates
  • -v flag for verbose output

Generate

$ quickdrop generate <prompt-file>

Generate an HTML document from a prompt file using AI assistance.

Usage:

$ quickdrop generate cv.txt
$ quickdrop generate business-case.txt

Process:

  • Reads content from specified prompt file
  • Sends prompt to AI generation service
  • Creates HTML file with same base name (e.g., cv.txt → cv.html)
  • Automatically opens result in default browser

Browser Support:

  • macOS: Opens in default browser
  • Linux: Uses xdg-open
  • Windows: Opens in default browser

Error Handling:

  • Validates prompt file exists
  • Reports generation failures with HTTP status
  • Cleans up HTML file on generation failure
  • Requires authentication

List

$ quickdrop list

List all your deployed pages with their URLs and deployment IDs.

Shows:

  • Live URL
  • Site ID (needed for versions/rollback)
  • Original filename
  • Creation date

Summary

$ quickdrop summary

View analytics and deployment statistics for all your sites.

  • Total views and unique viewers
  • View trends over time
  • Geographic distribution

Detail

$ quickdrop detail <site-id>

View comprehensive analytics for a specific deployment.

Example Output:

Analytics Detail for site: abc123def456

File: presentation.html
URL: https://quickdrop.host/v/abc123def456

Summary:
• Total Views: 247
• Unique Viewers: 89
• Views (Last 30 days): 156

Top Viewers:
• 192.168.1.100
  Views: 45
  Last view: 2025-02-12T14:30:00Z

Device Breakdown:
• Desktop: 180 views
• Mobile: 52 views
• Tablet: 15 views

OS Breakdown:
• Windows: 120 views
• macOS: 85 views
• iOS: 42 views

Analytics Categories:

  • Basic Information: Filename and live URL
  • View Metrics: Total, unique, and recent views
  • Top Viewers: IP addresses with view counts and timestamps
  • Device Analysis: Breakdown by device type
  • OS Distribution: Viewing patterns by operating system

Features:

  • Real-time analytics retrieval
  • 30-day view tracking
  • Detailed viewer analytics
  • Device and OS statistics

Requirements:

  • Valid site ID
  • Authentication required
  • Access permissions to the specified site

Error Handling:

  • Validates site ID presence
  • Checks for site existence and permissions
  • Reports API connection failures

Delete

$ quickdrop delete <site-id> [--force]

Permanently delete a deployment and all its versions.

Example:

$ quickdrop delete abc123def456

Shell Auto-completion for bash CLI

Enable command auto-completion in ZSH:

eval "$(_QUICKDROP_COMPLETE=zsh_source quickdrop)"

Add this line to your ~/.zshrc file.