Skip to content

yesoreyeram/yesoreyeram-boomtheme-panel

Repository files navigation

⚠️ DEPRECATION

Grafana Boom Theme Panel was created during early Grafana days to workaround theme support for Grafana dashbaords. Given that Grafana have native themes now, It is time to deprecate the plugin.

Thank you community for the support. This plugin will be removed/archived from the grafana plugin catalog. Existing installations should continue to work. If that doesn't work, reach out to community.grafana.com for support. You can also download old binaries from releases page.

Boom Theme Panel

Build & Publish Release

Theme switcher with custom styles / themes for grafana dashboards.

image image

Features

  • Theme switcher
  • Multiple themes per dashboard
  • Theme builder
  • External stylesheets support
  • Add inline styles to themes to override styles
  • Add many themes as possible without rebuilding / restarting grafana
  • Users can change the themes without editing the dashboard
  • Dashboard specific themes

Creating Theme

Themes can be created with multiple building blocks like background image, base theme etc.

Property Description
Base theme Themes can be built on top of default/dark/light theme. Default is Default Theme
Background image Optional property. Can be blank. If specified more than once, last wins. Value should be valid image URL
CSS url External theme file. Should be valid CSS file URL
Custom Style / CSS Override CSS Styles. Should be valid css
Panel container BG Background color for the panels

Supported Grafana version

This grafana plugin is tested with the following grafana versions, But other versions are also expected to work.

  • Grafana version 8.x
  • Grafana version 7.x
  • Grafana version 6.x

Notes

  • When adding external stylesheets, make sure CORS enabled for those domains.

  • To make panel invisible : Modify following theme panel settings:

    • transparent = true
    • title = ""
    • Disable Theme Picker using panel settings
    • Move this panel to the bottom of the dashboard
    • Adjust the height and width if required.

Known issues / Limitations

  • If any custom plugin is used, dark/light theme switch, base theme will not work for those custom plugins. Refer this github issue

  • Theme panel should be within view port. Otherwise, Grafana won't render the theme. Refer this

Installation Instructions

There are multiple ways to install this plugin into your grafana instance

Download and extract zip file

Download the zip file from github releases page and extract into your grafana plugin folder. Then restart Grafana.

Using grafana-cli

If you are using grafana-cli, execute the following command to install the plugin

grafana-cli plugins install yesoreyeram-boomtheme-panel

or for specific versions

grafana-cli --pluginUrl https://github.com/yesoreyeram/yesoreyeram-boomtheme-panel/releases/download/v0.2.1/yesoreyeram-boomtheme-panel-0.2.1.zip plugins install yesoreyeram-boomtheme-panel

Using helm chart

If you use helm chart to provision grafana, use the following config to install the plugin

plugins:
  - yesoreyeram-boomtheme-panel

or for any specific versions

plugins:
  - https://github.com/yesoreyeram/yesoreyeram-boomtheme-panel/releases/download/v0.2.1/yesoreyeram-boomtheme-panel-0.2.1.zip;yesoreyeram-boomtheme-panel