v8.0.0-alpha.8

In this release

We're continuing to release Alpha versions at a faster cadence! Most importantly, this release fixes a bunch of Windows-specific import path bugs from the ESM migration.

Breaking Changes

• @electron-forge/publisher-github now exports a PublisherGitHub constructor rather than PublisherGithub (fixed capitalization).

What's Changed

• fix(plugin-vite): ignore .git directory in dev mode file watcher by @erickzhao in #4213
• fix(core): convert absolute file path to file URL in locateElectronExecutable by @erikian in #4214
• fix(init): ensure base tmpl scripts are added to package.json by @erickzhao in #4215
• fix: use file:// URLs when dynamically importing local paths by @erikian in #4217
• fix: tracer exception when tracing forge v8 by @MarshallOfSound in #4220
• feat(template): replace eslint/prettier with oxc.rs stack by @erickzhao in #4186
• feat(publisher-github)!: Github -> GitHub by @erickzhao in #4224
• refactor: replace fast-glob with built-in node:fs glob by @MarshallOfSound in #4227
• fix(template): update .gitignore by @erickzhao in #4221
• chore(template): remove stale nodeIntegration instructions by @erickzhao in #4223
• refactor(plugin-vite): use codeSplitting:false for preload by @erickzhao in #4222
• fix(maker-msix): ensure output has version and arch by @erickzhao in #4225
• fix(maker-msix): use path.basename(dir) for artifact by @erickzhao in #4230
• feat(plugin-vite): run main/preload dev builds in subprocess workers by @MarshallOfSound in #4226
• feat: add notarization support to MakerPKG by @MarshallOfSound in #4234
• chore: bump version to 8.0.0-alpha.8 by @MarshallOfSound in #4235

Full Changelog: v8.0.0-alpha.7...v8.0.0-alpha.8

v8.0.0-alpha.7

What's new

In this version of Electron Forge, we've fixed up the webpack plugin, which had ESM/CJS-related runtime errors. The Vite plugin now also uses Vite 8, powered by rolldown!

Full Changelog

• build(deps): remove unused minimist dep by @erickzhao in #4171
• chore: remove additional eslint references by @erickzhao in #4178
• ci: upgrade actions/* to latest by @erickzhao in #4179
• feat(package): API returns result by @erickzhao in #4172
• build(deps): update transient dependencies by @erickzhao in #4182
• feat(template): use moduleResolution: bundler by @erickzhao in #4175
• build: patch out lerna for verdaccio publish by @erickzhao in #4185
• build: add knip for dead code detection by @MarshallOfSound in #4190
• refactor: replace got with native fetch API by @MarshallOfSound in #4189
• chore: fix got deps in lockfile by @erickzhao in #4191
• chore: resolve dependabot security alerts by @MarshallOfSound in #4204
• fix(plugin-webpack): ESM-compatible imports by @erickzhao in #4206
• chore: forward-ports by @erickzhao in #4205
• feat(plugin-vite): upgrade vite 8 by @0xlau in #4167
• chore: bump version to 8.0.0-alpha.7 by @erickzhao in #4212

New Contributors

• @0xlau made their first contribution in #4167

Full Changelog: v8.0.0-alpha.6...v8.0.0-alpha.7

v8.0.0-alpha.6

The ESM Release

This release marks the culmination of our journey to bump all of our first-party Electron packages to Node 22 LTS + ESM.

Electron Forge is now a set of ESM packages and requires at least Node.js 22.12.0 (the first version to support require(esm) in CommonJS).

All dependent @electron/ npm packages have been bumped to their latest major version.

• @electron/asar
  • Removed all default exports.
• @electron/fuses
  • No additional breaking changes beyond Node.js and ESM requirements.
• @electron/get
  • Removed deprecated nightly_mirror option. Use nightlyMirror instead.
  • Removed deprecated force option. Use cacheMode: ElectronDownloadCacheMode.WriteOnly instead.
• @electron/notarize
  • Removed deprecated altool notarization strategy. The tool parameter is no longer used.
• @electron/osx-sign
  • Removed deprecated signAsync, walkAsync, and flatAsync functions. The base sign, walk, and flat functions are now Promise-based exclusively.
• @electron/packager
  • ASAR is now enabled by default with unpack: '**/{.**,**/}/**/*.node' (you likely can removed the auto-unpack-natives Forge plugin).
  • derefSymlinks now defaults to true.
  • Hook arguments are now consolidated into a single object parameter and hooks are promisified.
• @electron/rebuild
  • Removed default export.
  • Removed unused nodeGypPath field from the Rebuilder object.
• @electron/universal
  • No additional breaking changes beyond Node.js and ESM requirements.
• @electron/windows-sign
  • No additional breaking changes beyond Node.js and ESM requirements.

Additionally, many other dependencies are bumped to their latest major version! Most notably, @electron-forge/plugin-vite now uses Vite 7.

Moving init and import out of @electron-forge/core

The init and import ("bootstrap") commands aren't useful once you have a Forge app working. Fundamentally, it doesn't make sense for them to exist within @electron-forge/core, especially since it also meant that all Forge apps ended up bundling webpack and vite in their node_modules (inherited from init depending on @electron-forge/template-*).

This release moves the core of the init and import logic into the create-electron-app package. 👍

What's next?

This is subject to change, but the next release will probably ship with:

• Vite 8
• Modern linting for templates
• Modern compiler options for TypeScript templates
• ESM bundling support for the Vite plugin

A full roadmap is available in #4082. (If you have any feedback or comments, feel free to leave them in the issue!)

Yours truly,
@erickzhao

Changelog

• fix(template): modernize eslint deps by @erickzhao in #4132
• feat!: Node 22 + ESM by @erickzhao in #4059
• chore: add local claude code settings to .gitignore by @erickzhao in #4158
• build: isolate yarn cache when running verdaccio by @erickzhao in #4161
• feat(create-electron-app)!: move init and import out of core by @erickzhao in #4148
• perf(plugin-vite): run production builds in isolated subprocesses by @MarshallOfSound in #4163
• fix(plugin-vite): improve child logging by @erickzhao in #4165
• build: replace eslint with oxlint by @erickzhao in #4169
• chore: bump version to 8.0.0-alpha.5 by @erickzhao in #4173
• fix: prune final require calls by @erickzhao in #4176
• chore: bump version to 8.0.0-alpha.6 by @erickzhao in #4177

Full Changelog: v8.0.0-alpha.4...v8.0.0-alpha.6

v8.0.0-alpha.5

(don't use this release)

v8.0.0-alpha.4

What's Changed

• test: fix slow tests on next branch by @erickzhao in #4076
• build: improve version + publish flow by @erickzhao in #4078
• ci: use .nvmrc file for CI by @erickzhao in #4081
• test: move AssetRelocatorPatch tests to slow tests by @erickzhao in #4080
• feat(import)!: remove Forge 5 import code by @erickzhao in #4083
• feat(core)!: remove rechoir + lodash templates from config loader by @erickzhao in #4066
• ci: optimize Windows builds with faster D:\ drive by @MarshallOfSound in #4038
• test: upgrade to Vitest 4 by @erickzhao in #4079
• build(deps): replace ts-node with tsx by @erickzhao in #4085
• build(deps): update lint-roller to latest major version by @erickzhao in #4086
• fix(maker-wix): set default arch by @ShGKme in #3859
• fix(core): prevent duplicate app restarts when typing 'rs' multiple times by @MarshallOfSound in #4089
• ci: run post-merge on next branch by @erickzhao in #4090
• test(slow): test api against file: protocol fixtures by @erickzhao in #4087
• chore: fix formatting by @erickzhao in #4091
• test(slow): simplify bootstrapping tests by @erickzhao in #4096
• fix(template): add private: true by @erickzhao in #4103
• test: use verdaccio for e2e init testing by @erickzhao in #4100
• fix: interactive mode should proxy signals by @MarshallOfSound in #4102
• chore: remove pre-push hook by @erickzhao in #4117
• test: use verdaccio in more init cases by @erickzhao in #4119
• feat(init)!: add --package-manager flag by @erickzhao in #4107
• fix: apply correct version bump commit title by @erickzhao in #4122
• chore: bump version to 8.0.0-alpha.4 by @erickzhao in #4131

Full Changelog: v8.0.0-alpha.3...v8.0.0-alpha.4

v7.11.1

What's Changed

Forge v7.11 is the first version to be released using npm trusted publishing. A lot of internal build and test refactoring went into this release to make publishing seamless for releasers.

Full Changelog

• build: Yarn 4 CI hardening by @erickzhao in #4028
• feat(init): add --electron-version flag by @erickzhao in #4037
• build(deps): bump vite from 5.4.20 to 5.4.21 by @dependabot[bot] in #4036
• chore: update node-abi to latest by @erickzhao in #4046
• build(deps): bump brace-expansion from 1.1.11 to 1.1.12 by @dependabot[bot] in #4047
• build(deps): bump vite from 5.4.20 to 5.4.21 by @dependabot[bot] in #4049
• build: remove electronegativity plugin by @erickzhao in #4053
• build(deps): bump actions/download-artifact from 5.0.0 to 6.0.0 by @dependabot[bot] in #4041
• build(deps): bump actions/upload-artifact from 4.6.2 to 5.0.0 by @dependabot[bot] in #4042
• build(deps): bump actions/stale from 10.0.0 to 10.1.0 by @dependabot[bot] in #4044
• build(deps): bump actions/setup-python from 5.6.0 to 6.0.0 by @dependabot[bot] in #4040
• build(deps): bump actions/setup-node from 4.4.0 to 6.0.0 by @dependabot[bot] in #4043
• build(deps): bump actions/checkout from 5.0.0 to 6.0.0 by @dependabot[bot] in #4064
• build(deps): bump actions/setup-python from 6.0.0 to 6.1.0 by @dependabot[bot] in #4063
• fix(cli): mark vite plugin as experimental by @erickzhao in #4068
• ci: backport trusted publisher changes by @erickzhao in #4071
• chore: Revert "ci: backport trusted publisher changes (#4071)" by @erickzhao in #4077
• build(deps): bump node-forge from 1.3.1 to 1.3.2 by @dependabot[bot] in #4069
• ci: add trusted publishing to Forge 7 by @erickzhao in #4088
• docs: add next README notice by @erickzhao in #4093
• fix(template): add private: true by @erickzhao in #4101
• build(deps): bump jws from 4.0.0 to 4.0.1 by @dependabot[bot] in #4105
• test: backport test improvements from next by @erickzhao in #4106
• build(deps): bump actions/download-artifact from 6.0.0 to 7.0.0 by @dependabot[bot] in #4110
• build(deps): bump actions/upload-artifact from 5.0.0 to 6.0.0 by @dependabot[bot] in #4111
• build(deps): bump actions/setup-node from 6.0.0 to 6.1.0 by @dependabot[bot] in #4112
• build(deps): bump actions/checkout from 6.0.0 to 6.0.1 by @dependabot[bot] in #4113
• build(deps): bump actions/cache from 4.3.0 to 5.0.1 by @dependabot[bot] in #4114
• test: use verdaccio in more init cases by @erickzhao in #4116
• chore: version bump by @erickzhao in #4120
• fix: apply correct version bump commit title by @erickzhao in #4121
• chore: bump version to 7.11.0 by @erickzhao in #4123
• chore: use yarn workspace:* cross-references by @erickzhao in #4126
• chore: bump version to 7.11.0 by @erickzhao in #4127
• fix(create-electron-app): add missing repository field by @erickzhao in #4128
• chore: bump version to 7.11.1 by @erickzhao in #4129

Full Changelog: v7.10.2...v7.11.1

v8.0.0-alpha.3

Electron Forge 8

This is the first published release of the next branch, which contains code for future releases of Electron Forge 8. For now, the alpha stage indicates that the toolchain is still in active development and to use it at your own risk.

Eventually, a future beta stage will indicate that the toolchain ready for early adopters. For now, each Alpha release will note whenever breaking changes are released.

Breaking Changes

• feat(core)!: remove global module templates by @erickzhao in #4065
• fix(publisher-gcs)!: do not gzip artifacts by @MarshallOfSound in #4034
• feat!: expose artifact version to static publishers by @MarshallOfSound in #4033
• build: remove electronegativity plugin by @erickzhao in #4053

Other Changes

• feat(init): add --electron-version flag by @erickzhao in #4037

Internal

• build: Yarn 4 CI hardening by @erickzhao in #4028
• build(deps): bump vite from 5.4.20 to 5.4.21 by @dependabot[bot] in #4036
• chore: update node-abi to latest by @erickzhao in #4046
• build(deps): bump brace-expansion from 1.1.11 to 1.1.12 by @dependabot[bot] in #4047
• build(deps): bump vite from 5.4.20 to 5.4.21 by @dependabot[bot] in #4049
• test(fuses): use local modules instead of initLink by @erickzhao in #4057
• chore: use yarn workspace:* cross-references by @erickzhao in #4056
• chore: add eslint config change to .git-blame-ignore-revs by @erickzhao in #4062
• ci: set up npm trusted publishing by @erickzhao in #4070
• chore: bump version to 8.0.0-alpha.1 by @erickzhao in #4072
• build: target "next" branch in gh release create by @VerteDinde in #4074
• chore: bump version to 8.0.0-alpha.3 by @VerteDinde in #4075

Full Changelog: v7.10.2...v8.0.0-alpha.3

v7.10.2

What's Changed

Highlights

• fix(maker-msix): rename and add named exports by @erickzhao in #4020
• fix(msix): use temp staging folder and fix types by @MarshallOfSound in #4021
• build: upgrade to Lerna 9 and Yarn 4 by @georgexu99 in #4009
• fix(maker-squirrel): make app in tmpdir by @MarshallOfSound in #4022

Other Changes

• build: update yarn version by @georgexu99 in #4023
• build: correct lerna-publish version by @VerteDinde in #4024
• build: move husky to postinstall by @VerteDinde in #4025
• docs: update CONTRIBUTING to include build by @VerteDinde in #4027

Full Changelog: v7.10.0...v7.10.2

v7.10.1

Unfortunately, this release had an error in the final npm package. We're sorry for the inconvenience; we recommend upgrading directly to v7.10.2.

v7.10.0

The MSIX Release

Forge v7.10.0 adds experimental support for the MSIX packaging format on Windows. The new @electron-forge/maker-msix package adapts the standalone electron-windows-msix installer utility to work alongside the rest of the Electron Forge build and release pipeline.

npm install --save-dev @electron-forge/maker-msix

What's Changed

• fix(init): unbreak interactive force check by @erickzhao in #4007
• feat(msix): add maker-msix by @bitdisaster in #3978

New Contributors

• @bitdisaster made their first contribution in #3978

Full Changelog: v7.9.0...v7.10.0