Dropframe CLI (npx dropframe)

LLM-Native Web Hosting from your terminal.
Instantly deploy single-file HTML web applications to Cloudflare edge via npx dropframe deploy.

⚡ Quickstart

Deploy the index.html in your current directory with zero installation:

npx dropframe deploy

Or deploy a specific file with a name:

npx dropframe deploy dist/index.html --name "My App"

🔒 Security Architecture

npx dropframe is designed with security-first practices:

1. OAuth 2.1 with PKCE (S256): Authentication uses RFC 7636 PKCE with SHA-256 code challenges. Passwords or raw tokens are never requested or typed into the terminal.
2. Loopback Server Binding: The local OAuth callback server binds strictly to loopback interface 127.0.0.1 (never exposed on local network interface 0.0.0.0) and shuts down immediately upon code exchange or timeout.
3. Restricted Storage Permissions: Stored credentials are saved in ~/.config/dropframe/credentials.json with strict 0600 (read/write owner-only) permissions and directory 0700 permissions.
4. Environment Variable Override: Supports DROPFRAME_TOKEN for headless or CI/CD deployments without interactive browser logins.
5. Zero External Dependencies: Built with 100% native Node.js standard modules (node:http, node:crypto, node:fs, node:child_process), keeping the package size tiny, startup instant, and supply chain attack surface zero.

🛠 Commands

npx dropframe deploy [path]

Deploys an HTML file or project directory.

# Deploy current directory (looks for index.html)
npx dropframe deploy

# Deploy specific HTML file
npx dropframe deploy app.html

# Deploy with custom app name
npx dropframe deploy --name "Analytics Dashboard"

# Update an existing deployment by ID
npx dropframe deploy index.html --update app_123456

# Set custom domain (Pro/Max feature)
npx dropframe deploy --domain myapp.com

npx dropframe list

Lists all your active deployments with URLs, App IDs, tiers, and expiration status.

npx dropframe list

npx dropframe delete <id>

Permanently deletes a deployment by App ID.

npx dropframe delete app_123456

npx dropframe login

Interactively authenticates your terminal session with your Dropframe account using OAuth 2.1.

npx dropframe login

npx dropframe logout

Clears stored credentials from disk (~/.config/dropframe/credentials.json).

npx dropframe logout

npx dropframe status

Displays active session state and verifies connection with Dropframe API.

npx dropframe status

⚙️ Environment Variables

• DROPFRAME_TOKEN: Access token override (useful for CI/CD pipelines).
• DROPFRAME_HOST: Custom API server host (default: https://dropframe.run).

📄 License

MIT © Dropframe Team