← Back to Blog

Edge Drop Guides | Published Aug 21, 2026 | Updated Nov 21, 2026 | 6 min read

How to Build Edge Drop From Source on Windows

By Deepender Yadav

How to Build Edge Drop From Source on Windows — Edge Drop Guide

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

RequirementNotes
Windows 10 or Windows 11Edge Drop uses Windows-only APIs and builds for Windows x64 only
Node.js 18 or laterThe project README lists v18 as the minimum; npm comes with Node.js
GitTo 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

  1. 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.
  2. Open Windows Terminal or Command Prompt in the folder where you keep code.
  3. Clone the repository and move into it:
git clone https://github.com/Deepender25/Edge-Drop.git
cd Edge-Drop
  1. Install the dependencies:
npm install
  1. 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:

CommandWhat it does
npm run devRuns the app in development mode (electron-vite dev)
npm run buildCompiles the app without packaging it (electron-vite build)
npm run previewRuns the compiled build (electron-vite preview)
npm run typecheckType-checks the Node and web code with tsc --noEmit
npm testRuns the test suite (vitest run)
npm run build:githubBuilds, then packages an NSIS installer with electron-builder
npm run build:storeBuilds, then packages an MSIX/AppX package for the Microsoft Store (build:msix is the same)
npm run packageShortcut for build:github

There is no npm run dist script.

Build an installer

  1. Quit every running copy of Edge Drop, including any dev-mode window.
  2. Run:
npm run build:github
  1. When it finishes, open the dist folder in the project. The NSIS installer is there, named after the version in package.json (for example Edge-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:

FolderContents
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:

  1. Run npm run typecheck.
  2. Run npm test.
  3. 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

Sources

Deepender Yadav
Written by Deepender Yadav · Creator & Developer

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 · LinkedIn

Copy. 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
Find us on CodeHype