.png%3Falt%3Dmedia%26token%3D325f86f6-2e2a-4d0f-a8c7-b28d4eea56a4){kind=logo}
.png%3Falt%3Dmedia%26token%3D325f86f6-2e2a-4d0f-a8c7-b28d4eea56a4){kind=logo}
Build Lifecycle
How Forge takes your app code from development to distribution.
Once your app is ready to be released, Electron Forge can handle the rest to make sure it gets into your users' hands. The complete build flow for Electron Forge can be broken down into three smaller steps:
Forge's build flow
Each one of these steps is a separate command exposed through Forge's
electron-forge command line interface, and is usually mapped to a script in your package.json file.Cascading build steps
Running each of these tasks will also run the previous ones in the sequence (i.e. running the
electron-forge publish script will first run package and make as prerequisite steps).In the Package step, Forge uses Electron Packager to package your app. This means creating an executable bundle for a target operating system (e.g.
.app on macOS or .exe on Windows).This step also performs a few supporting tasks:
- Rebuilds native node add-ons for your app's Electron version.
By default, running the Package step will only create a packaged application for your machine's platform and architecture.
On bundling app code
Note that Forge does not perform any bundling of your app code for production in the Package step without additional configuration.
If you need to perform any custom JavaScript build tasks (e.g. module bundling with Parcel or webpack) for either renderer or main process code, see the Using lifecycle hooks section below.
After the Package step, your packaged application will be available in the
/out/ directory.Forge's Make step takes the bundled executable output from the previous Package step and creates "distributables" from it. Distributables refer to any output format that you want to distribute to users, whether it be an OS-specific installer (e.g.
.dmg or .msi) or a simple compressed archive (e.g. .zip) of the bundle.By default, running the Make step will only run Makers targeting your machine's platform and architecture.
After the Make step, distributable archives or installers are generated for your packaged app in the
/out/make/ folder of your project.Forge's Publish step takes the distributable build artifacts from the Make step and uploads for distribution to your app's end users (e.g. to GitHub Releases or AWS S3 static storage). Publishing is an optional step in the Electron Forge pipeline, since the artifacts from the Make step are already in their final format.
After the Publish step, your app distributables will be available to download by users.
Your Electron application might have custom build needs that aren't handled with the most basic Forge pipeline described above. To solve this issue, Electron Forge exposes callback hooks at various points in the build process.
These hooks can be used to implement custom logic that your application needs. For instance, you can perform actions between the Package and Make steps with the preMake hook.
If you want to share a specific sequence of build hook logic, you can modularize your hook code into a plugin instead. This is how Forge's Webpack Plugin works, for instance. For more details on authoring custom plugins, see the Writing Plugins guide.
By default, Electron Forge will only build your app for the operating system it's running on. Targeting a different operating system (e.g. building a Windows app from macOS) has many caveats.
If you don't have access to Windows, macOS, and Linux machines, we highly recommend creating a build pipeline on a Continuous Integration platform that supports all these platforms (e.g. CircleCI or GitHub Actions). For an example of CI builds in action, see Electron Fiddle's GitHub Actions pipeline.