Electron, React & Python Template

Multi-platform Electron template, using React & Redux Toolkit on the front-end and Python/Flask for microservices on the back-end.

🛠️ Setup

Ensure you have Node and Python installed, then clone this repository. After it's cloned, navigate to the project's root directory on your computer and run the following scrips in a terminal application (e.g., Git Bash):

Install Python dependencies:

pip3 install -r requirements.txt

Install Node dependencies:

yarn install

⚙️ Config

Electron: Electron's main.js, preload.js, and renderer.js files can be found in the project's root directory.

React: React files can be found in the ./src/ folder, the custom toolbar is in ./src/components/toolbar.

Python: Python scripts can be created in the ./app.py file and used on events via REST calls.

📜 Scripts

Below are the scripts you'll need to run and package your application, as well as build out JSDoc documentation, if you choose to do so. An exhaustive list of scripts that are available can be found in the package.json file of the project's root directory, in the scripts section.

Start Developer Mode:

yarn run start

Package Linux:

yarn run build:package:linux

Package macOS:

yarn run build:package:mac

Package Windows:

yarn run build:package:windows

Build Documentation:

yarn run build:docs

Note: For packaging, you must install PyInstaller and include its path in your environment variables. Windows uses electron-wix-msi, which must also be installed and have its path included in your environment variables. MacOS uses electron-installer-dmg.

🐱‍👓 Docs

Code documentation for this template, created with JSDoc, can be found here:
Electron, React, & Python Template

🦟 Bugs

Bugs reported on the project's issues page will be exterminated as quickly as possible, be sure to include steps to reproduce so they can be spotted easily.

🏷️ License

MIT © iPzard