Electron Builder

A complete solution to package and build a ready for distribution Electron app with “auto update” support out of the box
Alternatives To Electron Builder
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Electron Builder13,0127,5621,0132 days ago874July 24, 2023327mitTypeScript
A complete solution to package and build a ready for distribution Electron app with “auto update” support out of the box
Squirrel1,954224a year ago26August 23, 202262otherJava
squirrel-foundation is a State Machine library, which provided a lightweight, easy use, type safe and programmable state machine implementation for Java.
Builder1622452765 years agoApril 27, 20222mitGo
Fluent immutable builders for golang
Little Electron App17
7 years agoJavaScript
electron-builder를 이용한 일렉트론 자동 업데이트 앱
6 years agoMay 22, 2021mitGo
Light Object-Relational Environment (LORE) provides a simple and lightweight pseudo-ORM/pseudo-struct-mapping environment for Go
9 months agomitPHP
Entities and repositories support via attributes and repository generator
8 years agomitGo
Go query builder for pgx
Alternatives To Electron Builder
Select To Compare

Alternative Project Comparisons

electron-builder npm version downloads per month donate project discussions

A complete solution to package and build a ready for distribution Electron, Proton Native app for macOS, Windows and Linux with auto update support out of the box.

🔶 - Looking for additional maintainers!

We condemn Russias military aggression against Ukraine. We stand with the people of Ukraine.


Notes, Tasks, Projects.
All in a Single Place.

Your gateway to understanding your diabetes data

An open, source-available software licensing and distribution API

ToDesktop: An all-in-one platform for building and releasing Electron apps

Dashcam: Capture the steps to reproduce any bug with video crash reports for Electron.


See the full documentation on electron.build.

  • NPM packages management:
  • Code Signing on a CI server or development machine.
  • Auto Update ready application packaging.
  • Numerous target formats:
    • All platforms: 7z, zip, tar.xz, tar.7z, tar.lz, tar.gz, tar.bz2, dir (unpacked directory).
    • macOS: dmg, pkg, mas.
    • Linux: AppImage, snap, debian package (deb), rpm, freebsd, pacman, p5p, apk.
    • Windows: nsis (Installer), nsis-web (Web installer), portable (portable app without installation), AppX (Windows Store), MSI, Squirrel.Windows.
  • Publishing artifacts to GitHub Releases, Amazon S3, DigitalOcean Spaces and Bintray.
  • Advanced building:
    • Pack in a distributable format already packaged app.
    • Separate build steps.
    • Build and publish in parallel, using hard links on CI server to reduce IO and disk space usage.
    • electron-compile support (compile for release-time on the fly on build).
  • Docker images to build Electron app for Linux or Windows on any platform.
  • Proton Native support.
  • Downloads all required tools files on demand automatically (e.g. to code sign windows application, to make AppX), no need to setup.
Question Answer
I want to configure electron-builder See options
I have a question Join the discussions
I found a bug Open an issue
I want to support development Donate


Yarn is strongly recommended instead of npm.

yarn add electron-builder --dev

Note for PNPM

In order to use with pnpm, you'll need to adjust your .npmrc to use any one the following approaches in order for your dependencies to be bundled correctly (ref: #6389):


Note: Setting shamefully-hoist to true is the same as setting public-hoist-pattern to *.

Note for Yarn 3

Yarn 3 use PnP by default, but electron-builder still need node-modules(ref: yarnpkg/berry#4804). Add configuration in the .yarnrc.yaml as follows:

nodeLinker: "node-modules"

will declare to use node-modules instead of PnP.

Quick Setup Guide

electron-webpack-quick-start is a recommended way to create a new Electron application. See Boilerplates.

  1. Specify the standard fields in the application package.json name, description, version and author.

  2. Specify the build configuration in the package.json as follows:

    "build": {
      "appId": "your.id",
      "mac": {
        "category": "your.app.category.type"

    See all options. Option files to indicate which files should be packed in the final application, including the entry file, maybe required. You can also use separate configuration files, such as js, ts, yml, and json/json5. See read-config-file for supported extensions. JS Example for programmatic API

  3. Add icons.

  4. Add the scripts key to the development package.json:

    "scripts": {
      "app:dir": "electron-builder --dir",
      "app:dist": "electron-builder"

    Then you can run yarn app:dist (to package in a distributable format (e.g. dmg, windows installer, deb package)) or yarn app:dir (only generates the package directory without really packaging it. This is useful for testing purposes).

    To ensure your native dependencies are always matched electron version, simply add script "postinstall": "electron-builder install-app-deps" to your package.json.

  5. If you have native addons of your own that are part of the application (not as a dependency), set nodeGypRebuild to true.

Please note that everything is packaged into an asar archive by default.

For an app that will be shipped to production, you should sign your application. See Where to buy code signing certificates.


We do this open source work in our free time. If you'd like us to invest more time on it, please donate.

Popular Builder Projects
Popular Squirrel Projects
Popular Build Tools Categories

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Electron Builder