Skip to content

packaging.md

Latest commit

 

History

History
28 lines (21 loc) · 1.3 KB

packaging.md

File metadata and controls

28 lines (21 loc) · 1.3 KB
Raw

Packaging

The React application is built to frontend/dist and bundled into a PyInstaller onedir distribution. HelioSlate.exe starts the loopback API, opens the browser, and owns the tray icon.

scripts/build_windows.ps1 creates:

  • dist/HelioSlate/HelioSlate.exe;
  • dist/HelioSlate-Portable.zip;
  • an Inno Setup installer when ISCC.exe is available.

The packaged application does not require Python or Node on the target machine.

Upgrades

Installer releases retain the same Inno Setup application ID. Launching a newer HelioSlate-Setup.exe detects the existing installation, reuses its directory, closes files held by the running application through Windows Restart Manager, removes stale bundled runtime files, and updates in place. Mutable configuration, credentials, logs, and history live under %LOCALAPPDATA%\HelioSlate and are not inside the installation directory, so normal upgrades preserve them.

The setup program also terminates every HelioSlate.exe process tree before file replacement. Closing a browser tab does not stop collection: the desktop process remains intentionally available in the Windows notification area, where its tooltip shows current solar, home, and export power. The tray menu provides Open Dashboard and Exit; Exit shuts down the local API before ending.