whatisgithub

What is dropper?

dropper-devs/dropper — explained in plain English

Analysis updated 2026-05-18

37SwiftAudience · developerComplexity · 3/5LicenseSetup · moderate

In one sentence

A Mac menu bar app that uploads dropped files straight to your own Cloudflare R2 bucket and copies a share link to your clipboard.

Mindmap

mindmap
  root((Dropper))
    What it does
      Uploads files to your R2
      Generates share page link
      Copies link to clipboard
    Tech stack
      Swift
      Cloudflare R2
      Next.js
    Use cases
      Instant file sharing
      Own-domain share pages
      Pin and archive shares
    Audience
      Mac developers
    Setup
      Requires Cloudflare account
      Build with Xcode and make

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Share files instantly from a Mac menu bar without a third-party file-sharing service

USE CASE 2

Host share links on your own domain and storage instead of a middleman's servers

USE CASE 3

Build a collection of files with a generated gallery-style share page

USE CASE 4

Pin or archive shares without changing their public URL

What is it built with?

SwiftCloudflare R2Cloudflare WorkersNext.js

How does it compare?

dropper-devs/dropperdevkriter/capsos-agent-trackereyadhammouda/pookify
Stars373636
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires your own Cloudflare account, an R2 bucket, and an API token before first use.

Source-available: you can read, fork, and use it privately, but public distribution of builds and commercial use are not allowed.

So what is it?

Dropper is a Mac menu bar app for quickly sharing files. You drag a file onto its icon, and within seconds a link to a share page lands on your clipboard, ready to paste anywhere. What makes it different from typical file-sharing tools is that there is no company server sitting in the middle: the app uploads directly to your own Cloudflare R2 storage bucket, using credentials derived from a single Cloudflare API token you provide during onboarding. The share page itself is a static HTML page the app generates and uploads alongside your files. Each share is stored as a self-contained folder in your bucket, containing the generated page, an uploaded file or collection of files, optional thumbnail and poster images for video, and a manifest file that acts as the source of truth for the collection's contents, order, and display details. Pinning and archiving a share do not move or delete anything: they simply add or remove small marker files, so the public link never changes. Editing a collection, such as adding or removing items, updates the manifest and regenerates the page while keeping the same URL, and Dropper is careful to write in an order that means the live page never points to a file that has already been deleted. The project includes the macOS app itself, a small marketing website built with Next.js and deployed to Cloudflare Workers, and a lightweight separate Worker that serves the public share pages directly from R2 rather than through the main website code. Building it from source requires a recent Xcode toolchain on macOS 14 or later, and there are simple make commands to build, run, install, and test the app. Dropper is source-available rather than open source: you can read the code, fork it, and use it privately, but publicly distributing built copies or using it commercially is not permitted under its license.

Copy-paste prompts

Prompt 1
Help me set up Dropper with my own Cloudflare R2 bucket and API token.
Prompt 2
Explain how Dropper's manifest.json controls a share's contents and order.
Prompt 3
Walk me through building Dropper from source with make and Xcode.
Prompt 4
Show me how pinning and archiving work without changing the share URL.

Frequently asked questions

What is dropper?

A Mac menu bar app that uploads dropped files straight to your own Cloudflare R2 bucket and copies a share link to your clipboard.

What language is dropper written in?

Mainly Swift. The stack also includes Swift, Cloudflare R2, Cloudflare Workers.

What license does dropper use?

Source-available: you can read, fork, and use it privately, but public distribution of builds and commercial use are not allowed.

How hard is dropper to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is dropper for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.