Desktop Changing Default Settings

Introduction
In changing the Desktop App default settings, we assume you have followed the guide on Desktop App Environment Setup done 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 few folders that you need to take note of. From your root project directory, assets can be changed or customized in the following directories.
1
./src/ui/icons/
2
./src/ui/assets/
Copied!
Pay attention these files are React components and you can change them correctly. When the changes are done, generate your new files by running...
1
yarn build-assets
Copied!
Tray Icon
If you want to customize the TrayIcon, there are two ways:
- Open public/images/tray there you can check the all currents icons used by the application. You can change that 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.
1
// change ui/icon/AppIcon.tsx and run
2
yarn build-assets
Copied!
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.
1
const copyright = `© 2016-${new Date().getFullYear()}, Rocket.Chat`;
Copied!
Building and Packaging
We use electron-builder to "compile" and produce the executable files, just check the file electron-builder.json
Here you probably want to 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 probably there they 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:
1
yarn build
2
yarn release
Copied!
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 6mo ago

Export as PDF

Copy link

Edit on GitHub

Contents

Building and Packaging