Installation and Setup

Installation & Setup

---

Requirements

• Windows 10 / 11
• No additional runtime required (bundled with Electron)

---

Installing

1. Download the latest release
2. Run the installer (CyberTray-Setup-x.x.x.exe)
3. Follow the setup wizard
4. CyberTray launches automatically after installation

Windows SmartScreen

Windows may show a SmartScreen warning the first time you run the CyberTray installer; this is expected until Windows builds enough reputation for the file.

To continue:

1. Click More info.
2. Click Run anyway.

---

Keyboard Shortcuts

Key	Action	Scope
Alt+T (default)	Toggle CyberTray shelf	Global
Escape	Exit selection mode	Application
Ctrl+A	Select all shortcuts	Selection mode

---

Development

Prerequisites

• Node.js v22+
• npm

Setup

git clone https://github.com/CyberGems/CyberTray.git
cd CyberTray
npm install
npm run dev

Build for Production

npm run build
npm run build:electron

The installer will be in the release/ directory.

---

Architecture

Component	Technology
Framework	Electron 42 + React 19 + TypeScript
Bundler	Vite 6
Styling	CSS custom properties with glassmorphism

Dual-Window Architecture

Window	Purpose	Behavior
Shelf	Main shortcut panel	Resizable, always-on-top, slide animation
Handle	Activator bar	Non-focusable, mouse-pass-through, auto-hide

Communication uses Electron IPC via contextBridge. Hotspot polling runs at 200ms intervals.