Giter Club home page Giter Club logo

electron-forge's Introduction

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 | 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 @electron-forge/cli@beta init 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.

Team

Samuel Attard Mark Lee

electron-forge's People

Contributors

anaisbetts avatar anulman avatar bendemboski avatar bengotow avatar choxi avatar crevax avatar felixrieseberg avatar gitbook-bot avatar issacgerges avatar jacobq avatar leofidus avatar lukebatchelor avatar mako-taco avatar malept avatar marshallofsound avatar stanlemon avatar vintprox avatar waiteb3 avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.