EcoBridge Main App

EcoBridge Main App is the Electron application used for local EcoBridge device workflows. It runs as a normal desktop tray application by default and as the fullscreen EcoOS kiosk application when started with RUNTIME_ENV=sway.

Issue Reporting and Security

For reporting bugs, issues, or security vulnerabilities, please visit community.foss.global/. This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a code.foss.global/ account to submit Pull Requests directly.

Development

pnpm install
pnpm run build
pnpm exec electron-forge package --platform linux --arch x64

Useful scripts:

Command	Purpose
pnpm run build	Compile TypeScript and bundle the web frontend
pnpm run start	Start Electron through Electron Forge
pnpm run package	Package the app through Electron Forge
pnpm run test:playwright	Run the Playwright test entrypoint

Runtime Modes

Default desktop mode creates a tray icon, opens the main window, and shows a startup notification.

EcoOS mode is enabled with RUNTIME_ENV=sway. In this mode the app creates a fullscreen window and skips tray integration so it can be supervised by the EcoOS daemon inside Sway.

Release Assets

The Gitea release workflow runs on v* tags and publishes Linux x64 artifacts.

Asset	Purpose
EcoBridge-MainApp-vX.X.X-linux-x64.tar.gz	Portable Linux x64 package consumed by EcoOS
.deb / .rpm assets	Installer packages produced by Electron Forge
mainapp-update-manifest.json	Signed-update manifest used by EcoOS
mainapp-update-manifest.json.sig	OpenSSL signature for the manifest
SHA256SUMS.txt	SHA256 checksums for all release assets

The release workflow requires MAINAPP_UPDATE_MANIFEST_PRIVATE_KEY_PEM to sign the update manifest. EcoOS verifies the manifest with its pinned public key before installing the portable tarball.

EcoOS Integration

EcoOS installs the portable tarball under /opt/eco/mainapp/releases/<version> and points /opt/eco/mainapp/current at the active release. The EcoOS daemon launches /opt/eco/mainapp/current/ecobridge.xyz with Wayland/Electron flags and performs update checks, installs, restarts, health checks, and rollbacks.

Third-Party Notices

This app consumes @design.estate/dees-catalog, which includes Font Awesome Free icon packages. Font Awesome SVG/icon assets are licensed under CC BY 4.0 and Font Awesome code is licensed under MIT. See fontawesome.com for upstream license details.

License and Legal Information

This repository contains open-source code licensed under the MIT License. A copy of the license can be found in license.md.

Please note: The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.

Trademarks

This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.

Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.

Company Information

Task Venture Capital GmbH
Registered at District Court Bremen HRB 35230 HB, Germany

For any legal inquiries or further information, please contact us via email at hello@task.vc.

By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.