How to Build Edge Drop From Source on Windows
To build Edge Drop from source, install Node.js (version 18 or later, which includes npm) and Git on Windows, then run git clone https://github.com/Deepender25/Edge-Drop.git, npm install and npm run dev. That launches the app in development mode. To produce an installer like the one on GitHub Releases, run npm run build:github; the NSIS .exe appears in the dist folder.
Edge Drop is open source under the Apache License 2.0, so you can read, build and modify it freely. If you only want to use the app, the regular installer is quicker.
What you need
| Requirement | Notes |
|---|---|
| Windows 10 or Windows 11 | Edge Drop uses Windows-only APIs and builds for Windows x64 only |
| Node.js 18 or later | The project README lists v18 as the minimum; npm comes with Node.js |
| Git | To clone the repository |
Check that both tools are on your PATH:
node --version
npm --version
git --version
Clone and run Edge Drop in dev mode
- Quit any installed copy of Edge Drop first: right-click its tray icon and select Quit Edge-Drop. Two copies watching the clipboard at once makes testing confusing.
- Open Windows Terminal or Command Prompt in the folder where you keep code.
- Clone the repository and move into it:
git clone https://github.com/Deepender25/Edge-Drop.git
cd Edge-Drop
- Install the dependencies:
npm install
- Start the app in development mode:
npm run dev
npm run dev runs electron-vite dev, which builds the main process, preload and React renderer and launches Electron with hot module replacement, so renderer changes appear without restarting. Stop it with Ctrl+C in the terminal.
The main branch can contain changes that haven't shipped in a release yet. Compare against the changelog if something behaves differently from your installed copy.
The npm scripts
These are the scripts defined in the project's package.json:
| Command | What it does |
|---|---|
npm run dev | Runs the app in development mode (electron-vite dev) |
npm run build | Compiles the app without packaging it (electron-vite build) |
npm run preview | Runs the compiled build (electron-vite preview) |
npm run typecheck | Type-checks the Node and web code with tsc --noEmit |
npm test | Runs the test suite (vitest run) |
npm run build:github | Builds, then packages an NSIS installer with electron-builder |
npm run build:store | Builds, then packages an MSIX/AppX package for the Microsoft Store (build:msix is the same) |
npm run package | Shortcut for build:github |
There is no npm run dist script.
Build an installer
- Quit every running copy of Edge Drop, including any dev-mode window.
- Run:
npm run build:github
- When it finishes, open the
distfolder in the project. The NSIS installer is there, named after the version inpackage.json(for exampleEdge-Drop-Setup-0.4.0.exe).
npm run build:store produces the package used for Microsoft Store submission. For a copy you can install on your own PC, use build:github.
Edge Drop's update and Settings behaviour depends on which of these builds you make: the GitHub build includes the in-app updater and the Updates section, while the Store build has neither. How Edge Drop updates on GitHub builds explains the update modes.
How the code is organised
The README describes three layers:
| Folder | Contents |
|---|---|
shared/ | Types and the IPC channel definitions shared by both sides (types.ts, bridge.ts, ipc.ts) |
electron/main/ | The main process: window and cursor polling, tray, updater, fullscreen detection, drag-out |
electron/preload/ | The bridge that exposes a limited API to the renderer as window.edge |
electron/clipboard/ | The clipboard watcher and format handling, including the password-manager flags |
electron/store/ | History storage, settings and data paths |
src/ | The React renderer: the shelf, Settings, search, the emoji picker |
If you want to check a privacy claim yourself, these are the places to look. electron/clipboard/formats.ts holds the checks that skip a copy when Windows marks it as excluded from clipboard history or monitoring, and electron/store/ItemStore.ts encrypts the history index with Windows DPAPI. Images and long-text payloads are stored as plain files. Reading an Electron app's security settings explains what to look for in the window and preload code.
Common build problems
EBUSY: resource busy or locked
Packaging failed because a running Edge Drop holds files open. The README's fix: close every running Edge Drop instance, including dev mode, then run the build again. Check Task Manager for leftover Edge-Drop.exe processes if the error persists.
npm install fails to download Electron
npm install downloads the Electron binary. Proxies and some corporate networks block that download. Try another network, or follow the proxy instructions in the Electron documentation.
node or npm is not recognized
Node.js isn't on your PATH. Reinstall it from nodejs.org and open a new terminal window afterwards.
Dependencies look out of date
After pulling new commits, run npm install again so node_modules matches the updated lock file.
Contributing a fix
The README asks contributors to open an issue first for anything larger than a small fix, to agree on scope, and then to send a pull request from a feature branch. Before you open the pull request:
- Run
npm run typecheck. - Run
npm test. - Describe what you changed and how you tested it.
Bug reports without code are welcome too; how to report a bug in Edge Drop has a template. If you'd rather not write code at all, there are other ways to support the project, from a Store review to a donation.
FAQ
Is Edge Drop open source?
Yes. The full source is on GitHub under the Apache License 2.0.
Can I build Edge Drop for macOS or Linux?
No. The build targets are Windows x64 only, and the app relies on Windows APIs. The README lists macOS and Linux ports as roadmap items and welcomes help with a macOS port.
Which Electron version does Edge Drop use?
The project depends on Electron 45 (^45.1.0 in package.json), built with electron-vite and packaged with electron-builder.
Related reading
- How to Report a Bug in Edge Drop
- How to Check an Electron App's Security Settings (IPC)
- Open-Source Clipboard Licenses: Apache vs GPL vs MIT
- Where Edge Drop Stores Data on Disk
Sources
- Edge Drop repository (GitHub) — source code,
package.jsonscripts and dependencies. - Edge Drop README (GitHub) — prerequisites, build commands, project structure, EBUSY fix and contribution process.
- Node.js downloads — installing Node.js and npm.
- electron-builder — the packaging tool behind
build:githubandbuild:store. - Electron documentation — Electron installation and configuration.
Deepender Yadav created Edge Drop and builds and tests it, from the edge-hover shelf to each release. A B.Tech Computer Science Engineering student, Deepender writes the Edge Drop guides, comparisons and developer posts, and checks product details against the app's source code.
GitHub · LinkedInCopy. Stack. Drop.
Transform your clipboard into an interactive edge shelf. Stack, pin, and drag assets into any app with zero friction.
Download for Windows Get from Microsoft Store
How to Install Guide · First 10 Minutes Guide · Drag & Drop Guide · Edge Drop vs Win+V · Support
Free · Lightweight · Privacy First