Electron to SumJS Converter (e2s)

A powerful, universal tool to convert Electron applications to SumJS with minimal manual effort.

Features

• Universal IPC Bridge: Automatically maps ipcRenderer.invoke calls to your backend logic (window.processor) or native SumJS dialogues.
• Dynamic Transpilation: Converts Node.js backend code to browser-compatible JS, exposing exported functions globally.
• Native Shims: Includes built-in shims for fs, path, os, and crypto to support common Node.js patterns in the browser.
• Zero Config: Scans your project and handles the conversion automatically.

Installation

You can run it directly using npx:

npx electron-to-sumjs

Or install globally:

npm install -g electron-to-sumjs

Usage

1. Navigate to your Electron project's root directory.
2. Run the converter:

npx electron-to-sumjs

or if installed globally:

e2s

3. The converter will:

   • Create a sumjs_dist folder (formerly neutralino_dist).
   • Transpile your backend code.
   • Patch your HTML and Renderer JS.
   • Download the SumJS binaries and client.
   • Bundle everything into a ready-to-run application.

4. Run your new SumJS app:

./sumjs_dist/sumjs-win_x64.exe
# or generic name depending on config
./sumjs_dist/smartapp.exe

How it Works

Universal Bridge

The converter injects a smart shim.js that intercepts Electron IPC calls.

• ipcRenderer.invoke('my-function', arg) -> automatically calls window.processor.myFunction(arg).
• ipcRenderer.invoke('select-folder') -> automatically opens a Native Folder Dialog.

Backend Transpilation

Your processor.js (or main backend logic) is transpiled:

• module.exports, exports.foo -> converted to window.processor assignments.
• fs.readFileSync -> converted to await Neutralino.filesystem.readFile.

License

ISC