Build Instructions (OS X)

Follow the guidelines below for building Electron on OS X.


If you are using the Python downloaded by Homebrew, you also need to install following python modules:

  • pyobjc

Getting the Code

$ git clone


The bootstrap script will download all necessary build dependencies and create the build project files. Notice that we're using ninja to build Electron so there is no Xcode project generated.

$ cd electron
$ ./script/ -v


Build both Release and Debug targets:

$ ./script/

You can also only build the Debug target:

$ ./script/ -c D

After building is done, you can find under out/D.

32bit Support

Electron can only be built for a 64bit target on OS X and there is no plan to support 32bit OS X in future.


Test your changes conform to the project coding style using:

$ ./script/

Test functionality using:

$ ./script/