Creating Custom Cloud Themes

Ansible clients can use custom themes. Available theme editing and synchronization features depend on the client and server version.

Creating a theme

Create and test themes in the selected Ansible client. An external online editor is not an Ansible service.

  • Set a name for your theme using the name attribute
  • Set colors for elements using hex codes or the color picker
  • Press ‘Save and apply theme’ to push changes to all users of your theme

Checking your theme in-app

Once you have saved a theme for the first time, Ansible will send you a message with its sharing link. Open the link in the app to switch to your theme.

You can always switch to your theme in Settings > Chat Settings. On iOS and MacOS native app – Settings > Appearance.

Publishing your theme

Each theme has a asme.su/addtheme link which people can use to switch to your theme. You can choose a beautiful short link (e.g., https://asme.su/addtheme/desert) by changing the shortname attribute. If you add support for multiple platforms, the same link can be used for setting your theme on all of them.

Updating your theme

Your theme gets updated automatically for all its users whenever you save and apply changes.

Including a chat background

Your themes can include a custom wallpaper. To do this, simply go to Settings > Chat Settings > Chat Background. On iOS and MacOS native app – Settings > Appearance > Chat Background.

Open any background and tap the sharing button in the top right corner, then copy its asme.su/bg/... link. In the theme file, set this link as the value of the wallpaper attribute.

For Ansible Desktop, if you want to make the background tiled, add ?mode=tiled at the end of the link. For example:

wallpaper: asme.su/bg/-jI7lnO3DFABAAAA1vXcFaZP_Vo?mode=tiled

Creating themes in-app

If you prefer a more WYSIWYG approach, try creating themes using the in-app tools for customizing appearance. Ansible for Android and Ansible Desktop have advanced in-app theme editors. Ansible for iOS and MacOS allow choosing a custom accent color from the color wheel and a background, then saving the result as a custom theme.

After saving, test the theme in your client and on each platform it targets.

Read more

Back to top