An Electron app for configuring and running the various mCODE Extraction Clients. This project is based on this GitHub template for using Electron with Create React App (CRA). This template uses a monorepo-esque approach, with one package.json for the electron app at the root, and another for the CRA code in the react-app directory.

1. Install dependencies:

npm install

If using Windows Subsystem for Linux:

npm install --platform=win32

2. Install React dependencies:

cd react-app
npm install

3. Start Electron and React app, from the root:

npm start

This command will concurrently start the React app and Electron app

./electron/preload.js exposes the ipcRenderer API to the React app via Electron's contextBridge API. This allows any React component to securely use ipcRenderer by calling window.ipcRenderer

To include a more verbose API between the React app and the main process, modify ./electron/preload.js to expose more information to the window object. E.g.

// ./electron/preload.js
const { ipcRenderer, contextBridge } = require('electron');

contextBridge.exposeInMainWorld('api', {
  myApiFunction: () => {
    ipcRenderer.send('do-my-api-function');
  });
});

// ./react-app/some/react/component.js
window.api.myApiFunction();

This project comes pre-loaded with a script npm run build that will package both the React app into static assets, and the Electron app into a platform-distributable binary