previewdrop

PreviewDrop CLI

A live URL for every branch. Any app, any stack.

Command-line companion to previewdrop.dev — isolated preview environments for every branch you push. Point PreviewDrop at a Dockerfile (Django, Rails, Laravel, FastAPI, Next.js, Go, Rust — anything) and get a shareable HTTPS URL in under 60 seconds. Open a PR and the URL lands as a bot comment. Merge the PR and the preview cleans itself up.

This CLI lets you trigger deploys, watch builds, tail logs, and destroy previews straight from your terminal — or wire it into CI/CD.

Install

# Global
npm install -g previewdrop

# Or run ad-hoc
npx previewdrop <command>

Requires Node.js 18+

Quick start

You need a PreviewDrop account and at least one connected repo. Sign up free at previewdrop.dev and install the GitHub App — takes under a minute. Then:

# 1. Authenticate the CLI (opens your browser)
previewdrop login

# 2. Find your project ID
previewdrop list projects

# 3. Deploy any branch and wait for a live URL
previewdrop deploy <project-id> --branch feat/new-ui --wait

You'll see something like:

✓ Deployment started: a1b2c3d4-e5f6-7890-abcd-ef1234567890
  Preview URL: https://prv-a8c2f9.previews.previewdrop.dev
⠼ Status: building…
✓ Deployment ready!
  https://prv-a8c2f9.previews.previewdrop.dev

That URL is a full isolated environment. Share it with designers, PMs, QA, or clients — no VPN, no staging contention, no localhost tunneling.

Commands

login — authenticate

previewdrop login [--key <api-key>] [--host <url>]

Opens your browser to generate an API key and stores it locally (under ~/.config/previewdrop). For CI, pass a token directly:

previewdrop login --key $PREVIEWDROP_API_KEY

list — discover projects and deployments

previewdrop list projects
previewdrop list deployments <project-id> [--limit <n>]

deploy — trigger a preview

previewdrop deploy <project-id> [--branch <branch>] [--wait]

• --branch — any branch name (defaults to the project's configured default branch)
• --wait — block until the deployment reaches a terminal state. Exits 0 on ready, 1 on failed/stopped/expired. Makes this safe to drop into CI.

status — inspect a deployment

previewdrop status <deployment-id> [--watch]

Possible states: queued · building · deploying · ready · failed · stopped · expired.

--watch polls until a terminal state is reached, showing the live status inline.

logs — build + runtime logs

previewdrop logs <deployment-id>            # build log (nixpacks / Dockerfile output)
previewdrop logs <deployment-id> --runtime  # container stdout/stderr
previewdrop logs <deployment-id> --runtime --tail 500

Build logs include auto-detected diagnostics for common failures (missing env vars, lockfile conflicts, port binding issues, unsupported runtimes). Runtime logs are colour-coded by severity so errors jump off the page.

destroy — tear down a preview

previewdrop destroy <deployment-id> [--yes]

Stops the container and marks the deployment as stopped. --yes skips the confirmation prompt for scripts.

CI/CD

The primary reason the CLI exists. Every preview gets a unique HTTPS URL, so your pipeline can post it to Slack, attach it to a GitHub PR comment, or feed it into Playwright / Cypress for end-to-end tests against a real environment.

GitHub Actions

name: Deploy preview
on: pull_request

jobs:
  preview:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/setup-node@v4
        with: { node-version: 20 }

      - run: npm install -g previewdrop
      - run: previewdrop login --key ${{ secrets.PREVIEWDROP_API_KEY }}

      - name: Deploy branch
        run: previewdrop deploy ${{ secrets.PROJECT_ID }} --branch ${{ github.head_ref }} --wait

PreviewDrop already posts a bot comment + commit status check when the GitHub App sees the PR — this Action is for cases where you need the URL inside another job (e.g. for E2E tests), or where you run CI on a different platform.

GitLab CI / Jenkins / CircleCI

The CLI is a plain Node binary with a well-defined exit code, so it drops into any CI. Store PREVIEWDROP_API_KEY as a secret and run:

npm install -g previewdrop
previewdrop login --key "$PREVIEWDROP_API_KEY"
previewdrop deploy "$PROJECT_ID" --branch "$BRANCH_NAME" --wait

Exit 0 = ready · Exit 1 = failed/stopped/expired.

What PreviewDrop runs

Anything PreviewDrop's build layer can auto-detect or containerise via a Dockerfile:

• Backends: Django · Rails · Laravel · FastAPI · Flask · Spring Boot · Go · Rust · Express · Fastify · Hono · Node · PHP
• Frontend / full-stack: Next.js · Astro · Vite · Nuxt · Remix · SvelteKit · Gatsby · Angular
• Web exports: Expo · React Native + react-native-web

No YAML. No Kubernetes. No build-pipeline edits. No per-service resource tuning — one flat workspace price covers everything.

Why PreviewDrop

• Every branch, not just PRs. Push a spike, get a URL. PR bot comments are included when you open one — but the preview doesn't wait for a PR to exist.
• Any Docker-based backend. The branch-preview gap Vercel and Netlify can't cover — Django, Rails, Laravel, FastAPI, Spring Boot. Anything you can run in a container.
• Flat per-workspace pricing. One bill for the team. No per-seat tax, no per-resource usage billing, no bill-shock on a busy sprint.
• Auto-expiring + password-protected URLs. Safe to share with clients or stakeholders — the preview self-destructs on a schedule you control.
• Zero config. Install the GitHub App, pick a repo. Push. Done.

Links

• Website & signup — previewdrop.dev
• Pricing — previewdrop.dev/pricing
• Docs — previewdrop.dev/docs
• Source — github.com/gsdevelopmentromania-jpg/previewdrop
• Issues — github.com/gsdevelopmentromania-jpg/previewdrop/issues
• Support — [e-mail]

License

MIT — © 2026 Global Software Development SRL