Official Guides

Please make sure that you use the documents that match your Electron version. The version number should be a part of the page URL. If it's not, you are probably using the documentation of a development branch which may contain API changes that are not compatible with your Electron version. To view older versions of the documentation, you can browse by tag on GitHub by opening the "Switch branches/tags" dropdown and selecting the tag that matches your version.

FAQ

There are questions that are asked quite often. Check this out before creating an issue:

• Electron FAQ

Guides and Tutorials

• Setting up the Development Environment

  • Setting up macOS
  • Setting up Windows
  • Setting up Linux
  • Choosing an Editor

• Creating your First App

  • Installing Electron
  • Electron Development in a Nutshell
  • Running Your App

• Boilerplates and CLIs

  • Boilerplate vs CLI
  • electron-forge
  • electron-builder
  • electron-react-boilerplate
  • Other Tools and Boilerplates

• Application Architecture

  • Main and Renderer Processes
  • Using Electron's APIs
  • Using Node.js APIs
  • Using Native Node.js Modules
  • Inter-Process Communication

• Adding Features to Your App

  • Notifications
  • Recent Documents
  • Application Progress
  • Custom Dock Menu
  • Custom Windows Taskbar
  • Custom Linux Desktop Actions
  • Keyboard Shortcuts
  • Offline/Online Detection
  • Represented File for macOS BrowserWindows
  • Native File Drag & Drop

• Accessibility

  • Spectron
  • Devtron
  • Enabling Accessibility

• Testing and Debugging

  • Debugging the Main Process
  • Using Selenium and WebDriver
  • Testing on Headless CI Systems (Travis, Jenkins)
  • DevTools Extension
  • Automated Testing with a Custom Driver

• Packaging

  • Code Signing

• Distribution

  • Support
  • Mac App Store
  • Windows Store
  • Snapcraft

• Security

  • Reporting Security Issues
  • Chromium Security Issues and Upgrades
  • Electron Security Warnings
  • Security Checklist

• Updates

  • Deploying an Update Server
  • Implementing Updates in Your App
  • Applying Updates

Detailed Tutorials

These individual tutorials expand on topics discussed in the guide above.

• In Detail: Installing Electron

  • Global versus Local Installation
  • Proxies
  • Custom Mirrors and Caches
  • Troubleshooting

• In Detail: Electron's Versioning Scheme

  • semver
  • Stabilization Branches
  • Beta Releases and Bug Fixes

• In Detail: Packaging App Source Code with asar

  • Generating asar Archives
  • Using asar Archives
  • Limitations
  • Adding Unpacked Files to asar Archives
• In Detail: Using Pepper Flash Plugin
• In Detail: Using Widevine CDM Plugin
• Offscreen Rendering

• Glossary of Terms

API References

• Synopsis
• Process Object
• Supported Chrome Command Line Switches
• Environment Variables

Custom DOM Elements:

• File Object
• <webview> Tag
• window.open Function

Modules for the Main Process:

• app
• autoUpdater
• BrowserView
• BrowserWindow
• contentTracing
• dialog
• globalShortcut
• inAppPurchase
• ipcMain
• Menu
• MenuItem
• net
• powerMonitor
• powerSaveBlocker
• protocol
• session
• systemPreferences
• Tray
• webContents

Modules for the Renderer Process (Web Page):

• desktopCapturer
• ipcRenderer
• remote
• webFrame

Modules for Both Processes:

• clipboard
• crashReporter
• nativeImage
• screen
• shell

Development

See <development/README.md>