# Developers

## Integrate Your Plugin with Runner

To add a custom Description and Icon to your Plugin, you need to update your `manifest.json` file. In the example below you'll see how it works. You can add an `icon` and `description`. Optionally you can add an alternative icon for macOS dark mode with `iconDark`. Runner will pick those up and do the rest. 

The icons should have a 64×64 resolution to show up crisp in the search results. 

```javascript
{
    "name": "About Emoji Autocomplete",
    "identifier": "about",
    "script": "index.js",
    "handler": "onSelectAboutMenuItem",
    "icon": "iconRunner.png",
    "iconDark": "iconRunnerDark.png",
    "description": "Learn more about the Emoji Autocomplete plugin."
}
```

![](https://3120890740-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIzm5e8TyLiQLn7aK45%2F-LY8sHyJH78w_cerD3nX%2F-LY8sO55GomW6sAuqq8o%2FDevelopers-Integration.png?alt=media\&token=643865be-78fb-4000-a5af-03f641742d55)

![](https://3120890740-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LIzm5e8TyLiQLn7aK45%2F-LY8sHyJH78w_cerD3nX%2F-LY8sPVyTMIjq4-0IdRH%2FDevelopers-Integration-Dark.png?alt=media\&token=934e6e28-32e6-46e2-9e63-d63a78e3d9d4)

{% hint style="info" %}
**Custom UI**\
If your plugin relies on custom UI elements, please, add your key functionalities as commands to the menu bar like described above. Only this way users can find and see all the great functionalities you have to offer inside of Runner!
{% endhint %}