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
Last modified 29d ago
Export as PDF
Copy link
Edit on GitHub