Project name

SEBN Taskbar Client

Description

Desktop electron application for production windows PCs, that performs the task of a taskbar for quickly launching production programs, websites, displaying notifications and sending issues to a helpdesk.

Department

PIT

Maintainer

Mykyta Nehrych

Website

http://terdvp0001.sebn.com/sebn-taskbar-manager/

Type

Internal Software

Icon

faTableCellsLarge

Major technologies

• React.js 18
• Electron 22
• Ant Design 5
• Webpack 5
• ESLint, and Prettier are used to improve the developer experience

Getting Started

1. Using YARN, run the following command to install dependencies. Package.json use resolutions field.

yarn install --no-cache

1. Run the following command to build and start the development version of your app with live reloading.

yarn dev

Packaging

Install Autohotkey v2 with compiler to compile /bin scripts.

AHK replaced ffi-napi due to increased perfomance in windows manipulating and keyboard hook usage.

Run yarn package to build and package app in x64.

Run yarn package:x86 to build and package app in x86 (ia32).

Run yarn package:all to build and package app in x64-x86 arch(final size will doubled!).

.env file (.env.development and .env.production)

AUTOUPDATE_PRIMARY_URL=http://localhost:8000/media/updates/  // location of latest.yml and nsis setup
AUTOUPDATE_SECONDARY_URL=http://localhost:8000/media/updates2/  // reserve update server
AUTOUPDATE_PRIMARY_URL_X86=
AUTOUPDATE_SECONDARY_URL_X86=
AUTO_UPDATE_TIMEOUT_IN_MIN=15
AUTO_UPDATE_TIMEOUT_ADD_RANDOM_IN_MIN=  // if set, add random delay in range to fetch
BACKEND_URL=http://localhost:8000/api/
BACKEND_API_KEY=aOL43Ixr.WTb6QM3vsEtOiW67bhVc1hqM6468435_Example
CRASH_REPORTER_SUBMIT_URL=https://your-domain.com/url-to-submit  // if omit save dump in apps user data directory
DATA_ACQUISITION_URL=http://localhost:8000/
DEV_POSITION=true  // doesnt register as appbar and show on top of existed win taskbar
FETCH_WORKPLACE_TIMEOUT_IN_MIN=10
FETCH_WORKPLACE_ADD_RANDOM_IN_MIN=  // if set, add random delay in range to fetch
RXDB_PASSWORD=B5E63C0C7A5CE365ACE546D0DE91DBA24DF6D81GASDASDSACA_Example
TRANSPARENT_WINBAR=true  // set windows taskbar full transparency
EMAIL_HOST=1.1.1.1  // send main process error stack trace to admin
EMAIL_PORT=487
FROM_EMAIL=taskbar-client@example.com
ADMIN_EMAIL=admin@example.com

Common issues

• Issue with electron >= 21 with Memory Cage, Fatal error in V8: Fixed with forks @inigolabs\ffi-napi and @inigolabs\ref-napi

• Issue with @inigolabs\ref-napi: Command failed. Exit code: 2 Command: PYTHON=python3 node-gyp-build.

  Fixed with placing @inigolabs/ref-napi in resolutions, because @inigolabs/ffi-napi add it itself in own node_modules