Branding

Overview 

You can customize the application name, icon, description, copyright, version, etc. by editing the corresponding properties in mobrowser.conf.json located in the root directory of your project.

{
  "app": {
    "name": "App",
    "version": {
      "major": "1",
      "minor": "0",
      "patch": "0"
    },
    "author": "Company Name",
    "copyright": "Copyright © 2026 Company Name",
    "description": "Application description",
    "bundle": {
      "macOS": {
        "icon": "assets/app.icns",
        "bundleID": "com.company.App",
        "codesignIdentity": "",
        "codesignEntitlements": "assets/entitlements.plist",
        "teamID": "",
        "appleID": "",
        "password": ""
      },
      "Windows": {
        "icon": "assets/app.ico",
        "signCommand": "",
      },
      "Linux": {
        "icon": "assets/app.png"
      }
    },
    ...
  }
}

Application details 

We recommend that you provide version, author, copyright, and description if you build your application for Windows.

These properties will be displayed in the application Properties:

Application icon 

To change the application icon, just replace the existing platform-specific icon files in the assets folder in the root directory of your project with your own ones in the same format. Different platforms require different icon formats.

Windows 

The app icon is located in assets/app.ico. You can replace it with your own.

There’s no integrated software on Windows that allow generating ICO files. To save your time, we provide a built-in icon generator tool for Windows. You can use it to create an ICO file from a set of PNG files with different dimensions. Just put your PNG 32-bit images with the following names and dimensions into some directory:

Then, run the following command in the terminal from the root directory of your project:

npm run mobrowser icon -- --sources <path-to-directory> --output app.ico

The app.ico file will be generated in the root directory of your project.

You can replace the default icon located at assets/app.ico with the new one manually, or you can do it automatically using the following command:

npm run mobrowser icon -- -sources <path-to-the-folder>

This command will generate the new icon and put it into assets/app.ico replacing the existing one.

macOS 

The app icon for macOS is located in assets/app.icns. The icon must be in the *.icns format.

To create your own app icon, put your app icon images with the following names and dimensions into some directory:

Then, follow these steps:

1. Rename the directory to: icon.iconset.
2. Confirm the file extension when prompted.
3. Navigate to the directory containing your icon.iconset in the terminal.
4. Run iconutil with the following command: iconutil -c icns icon.iconset.
5. Your icon.icns will be generated in the current directory.

Linux 

The app icon for Linux is located in assets/app.png. The icon represents a simple image in the PNG format with the 128x128 dimension. This dimension is enough for most Linux distributions.