:electron: A complete tool for building and publishing Electron applications
Перейти к файлу
dependabot-preview[bot] 9e0e564be8 build(deps-dev): bump @types/node-fetch from 2.3.6 to 2.3.7
Bumps [@types/node-fetch](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node-fetch) from 2.3.6 to 2.3.7.
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node-fetch)

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>
2019-06-17 09:38:01 -07:00
.github feat(core): V6 API (#433) 2018-04-11 17:03:01 +10:00
ci feat: Node 8 support (#875) 2019-05-23 13:19:53 -07:00
packages build(deps): bump find-up from 4.0.0 to 4.1.0 (#948) 2019-06-17 09:37:35 -07:00
tools docs: ensure that the CLI package has a README on NPM 2019-03-21 18:14:14 -07:00
typings chore: fix sudo-prompt type definition 2019-06-15 12:53:53 -07:00
.appveyor.yml feat: Node 8 support (#875) 2019-05-23 13:19:53 -07:00
.babelrc chore: @babel/plugin-proposal-object-rest-spread isn't necessary as of Node 8 2019-06-15 12:53:53 -07:00
.cz.js Add cz scopes to be the packages in bolt workspaces 2018-04-16 11:49:19 +10:00
.editorconfig chore(core): add *.ts to .editorconfig (#527) 2018-07-06 11:35:26 +10:00
.eslintignore chore: replace tslint with eslint to lint mocha tests (#590) 2019-03-21 17:46:24 -07:00
.eslintrc.json chore: replace tslint with eslint to lint mocha tests (#590) 2019-03-21 17:46:24 -07:00
.gitignore docs: ensure that the CLI package has a README on NPM 2019-03-21 18:14:14 -07:00
.mocharc.json chore: upgrade dependencies (#701) 2019-02-28 22:19:33 -08:00
.now.json feat(core): V6 Docs (#496) 2018-05-01 00:49:39 +10:00
.npmignore chore: make type checking faster, type check entire repo at once 2018-10-24 16:24:27 +11:00
.nvmrc feat(core): V6 API (#433) 2018-04-11 17:03:01 +10:00
.travis.yml feat: Node 8 support (#875) 2019-05-23 13:19:53 -07:00
CHANGELOG.md Update CHANGELOG.md 2019-05-23 17:55:02 -07:00
CONTRIBUTING.md docs: link to website repository 2019-06-10 07:59:31 -07:00
LICENSE docs(LICENSE): add a license file 2016-12-03 23:55:46 +11:00
README.md docs: update links to website 2019-06-10 07:58:58 -07:00
SUPPORT.md refactor: convert from electron-download to @electron/get (#921) 2019-06-13 10:06:37 -07:00
package.json build(deps-dev): bump @types/node-fetch from 2.3.6 to 2.3.7 2019-06-17 09:38:01 -07:00
tsconfig.json refactor: make running tests better with --fast and --match utils 2018-11-24 17:03:22 +11:00
tsconfig.packages.json chore: update all deps for v6 2018-11-24 17:15:46 +11:00
yarn.lock build(deps-dev): bump @types/node-fetch from 2.3.6 to 2.3.7 2019-06-17 09:38:01 -07:00

README.md

Electron Forge

Linux/macOS Build Status Windows Build status Commitizen friendly npm version npm license status

A complete tool for building modern Electron applications.

Electron Forge unifies the existing (and well maintained) build tools for Electron development into a simple, easy to use package so that anyone can jump right in to Electron development.


🚨 🚧 WARNING 🚧 🚨

🏗️

The master branch is a rewrite of Electron Forge that will eventually be the 6.x series. If you are looking for the 5.x series (the version currently published to NPM), please view the 5.x branch.


Website | Goals | Docs and Usage | Configuration | Support | Contributing | Changelog

Getting Started

Note: Electron Forge requires Node 6 or above, plus git installed.

npm install -g @electron-forge/cli@beta
electron-forge init my-new-app
cd my-new-app
npm start

Alternatively, if you have a more recent version of npm or yarn, you can use npx, or yarn create.

npx create-electron-app my-new-app
# or
yarn create electron-app my-new-app

# then
cd my-new-app
npm start

Project Goals

  1. Starting with Electron should be as simple as a single command.
  2. Developers shouldn't have to worry about setting up build tooling, native module rebuilding, etc. Everything should "just work" for them out of the box.
  3. Everything from creating the project to packaging the project for release should be handled by one core dependency in a standard way while still offering users maximum choice and freedom.

With these goals in mind, under the hood this project uses, among others:

  • electron-rebuild: Automatically recompiles native Node.js modules against the correct Electron version.
  • Electron Packager: Customizes and bundles your Electron app to get it ready for distribution.

Docs and Usage

For Electron Forge documentation and usage you should check out our website: electronforge.io

FAQ

How do I use this with webpack/babel/typescript/random build tool?

As of Electron Forge 6+ by default we only do vanilla JavaScript but if you want to do some fancy build tool stuff you should check out the plugins section of our docs site. We currently have plugins for Webpack, Parcel and Electron Compile.

Contributing

Getting the code base running locally requires the bolt command installed globally. An example is given below.

npm i -g bolt
git clone https://github.com/electron-userland/electron-forge
cd electron-forge
# Installs all dependencies, don't run "yarn" or "npm install" yourself
bolt
# Builds all the TS code
bolt build

NOTE: Please ensure that all changes are committed using semantic commits, we expose a helper bolt commit to make this easier.

For more information you should check out our Contributing guide.

Team

Samuel Attard Mark Lee