/secure-electron-template

The best way to build Electron apps with security in mind.

Primary LanguageJavaScriptGNU General Public License v2.0GPL-2.0

secure-electron-template

A current electron app template with the most popular frameworks, designed and built with security in mind. (If you are curious about what makes an electron app secure, please check out this page).

Quality Gate Status Security Rating Maintainability Rating Bugs Vulnerabilities

Banner

Banner built with banner-maker!

Demo

Demo

Features

Taken from the best-practices official page, here is what this repository offers!

  1. Only load secure content - (Need help!)
  2. Do not enable node.js integration for remote content - ✅
  3. Enable context isolation for remote content - ✅
  4. Handle session permission requests from remote content - ✅
  5. Do not disable websecurity - ✅
  6. Define a content security policy - ✅
  7. Do not set allowRunningInsecureContent to true - ✅
  8. Do not enable experimental features - ✅
  9. Do not use enableBlinkFeatures - ✅
  10. Do not use allowpopups - ✅
  11. <webview> verify options and params - ✅
  12. Disable or limit navigation - ✅
  13. Disable or limit creation of new windows - ✅
  14. Do not use openExternal with untrusted content - ✅
  15. Disable remote module - ✅
  16. Filter the remote module - ✅
  17. Use a current version of electron - ✅

Included frameworks

Built-in to this template are a number of popular frameworks already wired up to get you on the road running.

Roadmap

There are a number of additions that I'd like to implement in this repository, namely auto-updating and more release-focused enhancements and test suites, but those are lower priority (but I welcome PRs!).

Architecture

For a more detailed view of the architecture of the template, please check out here. I would highly recommend reading this document to get yourself familiarized with this template.

How to get started

To get started, clone the repository by clicking the Use this template button, or through the command line (git clone https://github.com/reZach/secure-electron-template.git).

Once cloned, install the dependencies for the repo by running the following commands (you do not have to run the first command if your command line is already inside the newly cloned respository):

cd secure-electron-template
npm i
npm run dev

When you'd like to test your app in production, or package it for distribution, please navigate to this page for more details on how to do this.

FAQ

Please see our faq for any common questions you might have. NEW TO ELECTRON? Please visit this page.

Show us your apps!

If you've built any applications with our template, we'd love to see them!.