No description
Find a file
Shelley Vohr 4721dc0856
fix: opt into location services once device service has been started (backport: 3-0-x) (#14289)
* fix: opt into location services once device service has been started (#14253)

* fix: opt into location services once device service has been started

* refactor: provide fake location provider to mock geolocation reponses

* chore: add spec for navigator.geolocation api using fake location provider

* fix conflict
2018-08-24 08:23:15 -07:00
.circleci make sure tests don't run for GitHub releases. (#13701) 2018-07-17 10:57:59 -05:00
.github docs: update pr template with checklist (#13270) 2018-06-18 13:58:30 -07:00
atom fix: opt into location services once device service has been started (backport: 3-0-x) (#14289) 2018-08-24 08:23:15 -07:00
brightray fix: add method and referrer properties to app login event (backport: 3-0-x) (#14277) 2018-08-23 20:47:16 +09:00
build refactor: [gn] compile node with boringssl (#13285) 2018-06-19 10:39:43 -05:00
chromium_src mark worker thread taskrunner as WithBaseSyncPrimitives 2018-06-19 11:49:46 +10:00
default_app Replace default_app icon 2017-12-07 16:10:45 -05:00
docs Print error when removed webview attribute is used (backport: 3-0-x) (#14274) 2018-08-23 15:42:08 +09:00
docs-translations update references to renamed i18n repo 2018-03-02 12:05:49 -08:00
lib Print error when removed webview attribute is used (backport: 3-0-x) (#14274) 2018-08-23 15:42:08 +09:00
native_mate rename back to expected values 2018-06-27 10:05:15 +10:00
npm fix: electron path for postinstall (backport: 3-0-x) (#14197) 2018-08-19 12:54:39 -07:00
script ci: add better logging around request failures for releasing (#14245) 2018-08-21 13:31:44 -07:00
spec fix: opt into location services once device service has been started (backport: 3-0-x) (#14289) 2018-08-24 08:23:15 -07:00
tools update mac symbol dump (#12982) 2018-05-21 10:01:17 +09:00
vendor chore: bump libcc (3-0-x) (#14280) 2018-08-23 21:12:09 -07:00
.clang-format
.dockerignore Add testing for arm, arm64 and ia32 linux builds 2017-12-20 11:54:52 -05:00
.env.example chore: fix beta bumping in 3.0 (#14173) 2018-08-17 13:00:04 -07:00
.gitignore Merge pull request #12921 from electron/commit-package-lock 2018-05-16 11:47:21 -04:00
.gitmodules rename back to expected values 2018-06-27 10:05:15 +10:00
.remarkrc add remark lint to ensure fenced codeblocks are formatted properly. 2017-11-20 14:05:47 +08:00
.travis.yml Add arm64 task in travis ci 2017-08-22 10:02:51 +09:00
appveyor-override.yml Use vs2017-15.4.5 for AppVeyor 2018-08-10 14:16:23 -04:00
BUILD.gn fix: opt into location services once device service has been started (backport: 3-0-x) (#14289) 2018-08-24 08:23:15 -07:00
CODE_OF_CONDUCT.md Change Contact Emails (#12278) 2018-03-15 04:37:40 +09:00
common.gypi Disable node options in node config (#13323) 2018-06-20 17:10:37 +10:00
CONTRIBUTING.md add docs/development/README.md (#12373) 2018-03-20 15:36:48 -04:00
DEPS chore: bump libcc (3-0-x) (#14280) 2018-08-23 21:12:09 -07:00
Dockerfile Use Node.js 10 for CI builds 2018-06-19 11:49:45 +10:00
Dockerfile.arm64 Newer CI images (#12188) 2018-03-08 22:07:50 -05:00
Dockerfile.arm64v8 Update CI to use Node 8 2018-03-19 10:19:32 -04:00
Dockerfile.armv7 Update CI to use Node 8 2018-03-19 10:19:32 -04:00
Dockerfile.circleci Use Node.js 10 for CI builds 2018-06-19 11:49:45 +10:00
electron.gyp fix: opt into location services once device service has been started (backport: 3-0-x) (#14289) 2018-08-24 08:23:15 -07:00
features.gypi fix: enable osr (backport: 3-0-x) (#14219) 2018-08-20 10:45:53 -07:00
filenames.gypi fix: opt into location services once device service has been started (backport: 3-0-x) (#14289) 2018-08-24 08:23:15 -07:00
LICENSE Update license year 2018-01-01 00:51:40 +01:00
package-lock.json Bump v3.0.0-nightly.20180823 2018-08-23 21:23:48 -07:00
package.json Bump v3.0.0-nightly.20180823 2018-08-23 21:23:48 -07:00
README.md Update installation instructions 2018-05-14 14:06:22 +03:00
SECURITY.md Change Contact Emails (#12278) 2018-03-15 04:37:40 +09:00
toolchain.gypi chrome style plugin: remove check-auto-raw-pointer option 2018-06-19 11:49:43 +10:00
vsts.yml make sure tests don't run for GitHub releases. (#13701) 2018-07-17 10:57:59 -05:00

Electron Logo

CircleCI Build Status AppVeyor Build Status devDependency Status Join the Electron Community on Slack

📝 Available Translations: 🇨🇳 🇹🇼 🇧🇷 🇪🇸 🇰🇷 🇯🇵 🇷🇺 🇫🇷 🇹🇭 🇳🇱 🇹🇷 🇮🇩 🇺🇦 🇨🇿 🇮🇹. View these docs in other languages at electron/i18n.

The Electron framework lets you write cross-platform desktop applications using JavaScript, HTML and CSS. It is based on Node.js and Chromium and is used by the Atom editor and many other apps.

Follow @ElectronJS on Twitter for important announcements.

This project adheres to the Contributor Covenant code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to coc@electronjs.org.

Installation

To install prebuilt Electron binaries, use npm. The preferred method is to install Electron as a development dependency in your app:

npm install electron --save-dev [--save-exact]

The --save-exact flag is recommended for Electron prior to version 2, as it does not follow semantic versioning. As of version 2.0.0, Electron follows semver, so you don't need --save-exact flag. For info on how to manage Electron versions in your apps, see Electron versioning.

For more installation options and troubleshooting tips, see installation.

Quick start

Clone and run the electron/electron-quick-start repository to see a minimal Electron app in action:

git clone https://github.com/electron/electron-quick-start
cd electron-quick-start
npm install
npm start

Resources for learning Electron

Programmatic usage

Most people use Electron from the command line, but if you require electron inside your Node app (not your Electron app) it will return the file path to the binary. Use this to spawn Electron from Node scripts:

const electron = require('electron')
const proc = require('child_process')

// will print something similar to /Users/maf/.../Electron
console.log(electron)

// spawn Electron
const child = proc.spawn(electron)

Mirrors

Documentation Translations

Find documentation translations in electron/i18n.

Community

Info on reporting bugs, getting help, finding third-party tools and sample apps, and more can be found in the support document.

License

MIT

When using the Electron or other GitHub logos, be sure to follow the GitHub logo guidelines.