Desktop Changing Default Settings

Introduction
In changing the Desktop App default settings, we assume you have followed the guide on Desktop App Environment Setup and that you are familiar with the development stack (git/node/javascript/electron).
Assets
Usually, the first thing you want to change is the icons. There are a few folders that you need to take note of. From your root project directory, assets can be changed or customized in the following directories.
./src/ui/icons/
./src/ui/assets/
Pay attention that these files are React components and you can change them correctly. When the changes are done, generate your new files by running...
yarn build-assets
Tray Icon
If you want to customize the TrayIcon, there are two ways:
- Open public/images/tray there you can check all current icons used by the application. You can change files if you want.
- Open and change ui/icon/AppIcon.tsx this is the icon base used to automatically generate all the icons, if you are used with tsx/jsx probably this is the easiest way to go.
// change ui/icon/AppIcon.tsx and run
yarn build-assets
About
To change the about screen, head on to ./src/ui/components/AboutDialog/index.tsx where you can change the copyright. If you've changed the logo already, it will automatically reflect on this page.
const copyright = `© 2016-${new Date().getFullYear()}, Rocket.Chat`;
Building and Packaging
We use electron-builder to "compile" and produce the executable files, just check the file electron-builder.json
Here you should change all references to the term rocket.chat/rocket/chat.rocket/rocketchat according to what each setting means.
The electron-builder has a webpage explaining what each attribute means, and cover other uses that we don't. https://www.electron.build/configuration/configuration​
You probably should look at this section if you want to maintain the automatic update: https://www.electron.build/configuration/publish​
After that you just need to run the following commands:
yarn build
yarn release
For more information or to see how we configure the CI/CD, please check out https://github.com/RocketChat/Rocket.Chat.Electron​

Desktop App - Previous

Desktop App White Labelling

UI Components

Last modified 2mo ago

Export as PDF

Copy link

Edit on GitHub

On this page

Introduction

Assets

Tray Icon

About

Building and Packaging