Plugins 〉Boom Theme


Developer

Sriramajeyam Sugumaran

Sign up to receive occasional product news and updates:


Grafana Cloud
Grafana Cloud
  • Grafana, of course
  • 10k series Prometheus metrics
  • 50 GB logs
  • 50 GB traces
  • 2,232 app o11y host hours
  • ...and more
Create free account

No credit card needed, ever.


The Boom Theme plugin has been deprecated and is no longer maintained.

Panel
community

Boom Theme

  • Overview
  • Installation
  • Change log
  • Related content

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.

PropertyDescription
Base themeThemes can be built on top of default/dark/light theme. Default is Default Theme
Background imageOptional property. Can be blank. If specified more than once, last wins. Value should be valid image URL
CSS urlExternal theme file. Should be valid CSS file URL
Custom Style / CSS OverrideCSS Styles. Should be valid css
Panel container BGBackground 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

Installing Boom Theme on Grafana Cloud:

For more information, visit the docs on plugin installation.

Installing on a local Grafana:

For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.

1. Install the Panel

Use the grafana-cli tool to install Boom Theme from the commandline:

grafana-cli plugins install 

The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.

2. Add the Panel to a Dashboard

Installed panels are available immediately in the Dashboards section in your Grafana main menu, and can be added like any other core panel in Grafana.

To see a list of installed panels, click the Plugins item in the main menu. Both core panels and installed panels will appear.

CHANGELOG

VersionChanges
0.2.1Bug fixes (Thanks @koszti)
Replace theme by variable (Thanks @koszti)
0.2.0Plugin Signed
Tagged releases
Bug fixes
0.1.0First version for release
0.0.4Base theme option
Bug fixes (#4)
0.0.3Schema changes (BREAKING)
Option to switch between default dark,light themes
BG Image as theme option
Bug fixes
0.0.2Multiple Themes, Theme picker
0.0.1Base version