electron-packager
github.com
- Free plan
- Windows
- macOS
- Linux
What electron-packager is
electron-packager turns Electron app source code into application folders containing a renamed Electron executable and supporting files for distribution. It is a free, open-source Node.js library and command-line tool, usable from the CLI or JavaScript. Packager can find or download the matching Electron release, then create bundles for a selected platform and architecture, all valid combinations or the host combination. Targets include Windows, macOS—including Mac App Store targets—and Linux; these are also listed as supported host systems. Documented architectures include x86, x86_64, arm64, universal macOS, Linux armv7l and Linux mips64el, though some choices depend on Electron versions. CLI options include a regular-expression ignore filter for files and folders. Electron Forge uses Packager internally, and installer tools can use its output folders to create distributables. The package requires Node.js 22.12.0 or higher, and local installation is recommended. Signing a macOS or Mac App Store bundle requires a macOS host. The project also notes that packaged Electron apps can be relatively large, with a minimal zipped app approximately the size of its matching zipped Electron binary.
Who it suits
It suits developers packaging Electron applications for Windows, macOS or Linux who can use Node.js and want CLI or JavaScript access. A macOS host is needed to sign macOS bundles.
Good to know, and what to watch
- CLI and JavaScript library interfaces
- Can find or download matching Electron releases
- Supports Windows, macOS and Linux targets
- Ignore option filters files and folders
- Requires Node.js 22.12.0 or higher
- Mac app signing requires a macOS host
- Packaged apps can be relatively large
Plans
Every plan and priceFree
Free plan
The verdict
electron-packager provides a direct path from Electron source to platform-specific application bundles, with both command-line and library interfaces. Check the Node.js requirement, target architecture availability and macOS signing constraint before choosing a build setup.
What the maker publishes
- API plugins
- The project lists API-hook plugins for locale selection, non-proprietary FFmpeg codecs, and rebuilding native Node.js modules. source
- Architecture support
- Documented target architectures include x86, x86_64, arm64, universal macOS, Linux armv7l, and Linux mips64el, with some architecture availability limited by Electron versions. source
- Build behavior
- Packager can find or download the matching Electron release and create an app bundle for a chosen platform and architecture, all valid combinations, or the host combination. source
- Configuration
- The CLI supports optional flags, and its ignore option filters files and folders with a regular expression. source
- Host platforms
- The project lists Windows, macOS, and Linux as supported host platforms for running Packager. source
- Integrations
- Electron Forge uses Electron Packager internally, while related installer tools use Packager-created folders to create distributables. source
- Interfaces
- It can be used as a command-line tool or as a Node.js library through JavaScript. source
- Prerequisite
- The module requires Node.js 22.12.0 or higher and the project recommends installing it locally rather than globally. source
- Purpose
- Electron Packager bundles Electron app source code with a renamed Electron executable and supporting files into folders ready for distribution. source
- Security
- GitHub reports that the project has not set up a SECURITY.md security policy. source
- Signing limit
- A macOS or Mac App Store app bundle can only be signed when the build runs on a macOS host. source
- Size limit
- The project notes that packaged Electron apps can be relatively large, with a minimal zipped app approximately the size of the matching zipped Electron binary. source
- Support
- The project directs usage questions to its FAQ and troubleshooting questions to its contributing documentation. source
- Target platforms
- It generates application bundles for Windows, macOS including Mac App Store targets, and Linux. source
Checked against the maker's pages on 7 Oct 2026.