---
title: "Split Flap panel changelog for Grafana"
description: "A retro-style Split Flap display panel for Grafana. Perfect for visualizing counters, metrics, and status codes with a classic airport terminal aesthetic."
---

> This is the Markdown version of https://grafana.com/grafana/plugins/dzaczek-splitflap-panel/changelog/

# Split Flap - Change log

# Changelog

## 2.4.1 (2026-04-16)

### Features

- **Board (Solari) Display Mode**: Added a new `Board` display mode that renders data as a classic Solari departure-board layout with configurable header, title, column names, row numbers, compact layout, and scrolling support.
- **True Wall Display**: Added `True Wall` styling variant for the Board mode with fixed column widths and per-digit recess effect for a realistic recessed-cell Solari board appearance.
- **Uniform Digit Width in Board Split Mode**: Digits per column are now padded to a uniform count so rows stay visually aligned even when values have different lengths.
- **Threshold Coloring in Board Rows**: Panel-level threshold configuration is now respected when coloring Board mode row values.
- **Board Demo Dashboard**: Added a provisioned demo dashboard (`board-demo.json`) for easy out-of-the-box testing of the Board mode.

### Improvements

- **Board Mode UX**: Auto-generated column names, optional row numbers, compact layout toggle, and vertical scrolling for long data sets.
- **Alignment Options**: Board mode rows support left, center, and right alignment.

### Maintenance

- **Security Patches**: Updated `yarn` resolutions to address multiple security vulnerabilities:

  - `dompurify`: 3.2.5 → 3.4.0 (GHSA-39q2-94rc-95cp)
  - `lodash`: 4.17.21 → 4.18.1
  - `picomatch`: 4.0.2 → 4.0.4
  - `serialize-javascript`: 7.0.3 → 7.0.5
  - `yaml`: 2.7.1 → 2.8.3
  - `immutable`: 5.0.3 → 5.1.5
  - `minimatch`: 9.0.6 → 10.2.3
  - `brace-expansion`: 2.0.3 → 5.0.5

- **Library Updates**:

  - `@grafana/ui` and `@grafana/i18n`: 12.3.2 → 12.4.2
  - `@emotion/css`: 11.10.6 → 11.13.5
  - `@testing-library/react`: 14.0.0 → 15.0.7
  - `webpack-cli`: 5.1.4 → 7.0.2
  - `style-loader`: 3.3.3 → 4.0.0
  - `eslint-webpack-plugin`: 5.0.2 → 6.0.0
  - `prettier`: 2.8.8 → 3.8.2
  - `@swc/helpers`: 0.5.18 → 0.5.21
  - `@types/node`: 20.19.30 → 25.6.0

- **Workflow & CI**:

  - `actions/checkout`: v4 → v6
  - `actions/upload-artifact`: v5 → v7
  - `softprops/action-gh-release`: v1 → v3
  - `grafana/plugin-actions`: updated `create-plugin-update` (v2.0.2) and `is-compatible` (v1.0.3)
  - Fixed `react-data-grid` installation issues and optimized Grafana compatibility workflow.

---

## 2.4.0-dev.1 (2026-04-16)

### Features

- Merged the `board` branch into `main` for development testing of the Board (Solari) mode features.

### Maintenance

- Updated `dompurify` resolution to `^3.4.0` to address Dependabot alert `#41` (`GHSA-39q2-94rc-95cp`).

---

## 2.4.0-beta.1 (2026-04-15)

### Features

- Added the Board (Solari) display mode with alignment controls, compact layout options, scrolling, and threshold-aware row rendering.
- Added the True Wall board styling and a provisioned demo dashboard for easier testing.
- Normalized digit widths per column in Board split mode so rows stay visually aligned even when values have different lengths.

### Maintenance

- Merged the `main` dependency and CI workflow updates into `board` for testing on top of the latest base.

---

## 2.3.1 (2026-04-15)

### Maintenance

- Merged the pending Dependabot updates for frontend packages and GitHub Actions workflows.
- Fixed the Grafana compatibility workflow to use the repository's committed Yarn lockfile instead of `npm ci`.
- Kept the Playwright report publishing job on `actions/checkout@v5` to avoid the `Duplicate header: "Authorization"` failure seen with `v6`.

---

## 2.2.7 (2026-01-09)

### Fixes

- **Provisioning**: Fixed Docker Compose configuration to use correct plugin ID (`dzaczek-splitflap-panel`), enabling proper provisioning and testing of the plugin.

---

## 2.2.1 (2026-01-08)

### Fixes

- **CI/CD**: Fixed dependency installation issues in GitHub Actions by switching `react-data-grid` to HTTPS protocol.
- **Linting**: Fixed missing dependency in `useEffect` hook in `FlipDigit` component.

---

## 2.2.0 (2026-01-08)

### Features

- **AM/PM Customization**: Added full control over AM/PM indicator in 12-hour clock mode:

  - **Position**: Can be placed Left, Right, or Inline (In Text).
  - **Orientation**: Support for Vertical (stacked characters) or Horizontal layout.
  - **Styling**: Independent control over font size and gap/spacing.
  - **Independent Rendering**: AM/PM is now rendered as a separate FlipDisplay component even in "In Text" mode, allowing for consistent styling and animation.

### Improvements

- **Clock Logic**: Optimized clock animation to use a dedicated 0-9 numeric drum for seconds/minutes, eliminating lag and "scrolling" through special characters during time changes.
- **Layout**: Improved layout engine for FlipItem to better handle "shrink-wrap" sizing, ensuring the clock stays centered regardless of timezone or AM/PM alignment.

---

## 2.1.38 (2025-12-12)

### Fixes

- **Flip Animation Logic**: Fixed a synchronization issue where the bottom half of the digit changed too early (before the flap finished falling). Now implements correct split-flap physics:

  - Top half reveals the new character immediately.
  - Bottom half keeps the old character until covered by the falling flap.
  - Falling flap transitions from old character (front) to new character (back).

- **Animation Speed**: Adjusted default flip duration from 0.6s to 0.49s for snappier, more realistic mechanical movement.

### Documentation

- **Intro Rewrite**: Made the README introduction more accessible and developer-friendly.

---

## 2.1.37 (2025-12-12)

### Summary

This release represents a major evolution of the Split Flap Panel, with significant improvements across security, architecture, themes, and documentation. The journey from 1.1.31 to 2.1.37 has been organized into three main development stages:

1. **Etap 1: Security & Architecture Overhaul (1.1.32)** - Complete security hardening and React migration
2. **Etap 2: Theme Expansion & Visual Enhancements (1.2.x - 2.0.x)** - Major theme expansion from 9 to 22 themes
3. **Etap 3: Final Polish & Documentation (2.1.x)** - Comprehensive documentation updates

### Statistics

- **Themes**: Expanded from 9 to 22 themes (+144% increase)
- **Security**: Eliminated all XSS vulnerabilities, full CSP compliance
- **Code Quality**: Migrated 754 lines of legacy code to modern React architecture
- **Documentation**: Complete rewrite covering all features and options

### Statistics

- **Themes**: Expanded from 9 to 22 themes (+144% increase)
- **Security**: Eliminated all XSS vulnerabilities, full CSP compliance
- **Code Quality**: Migrated 754 lines of legacy code to modern React architecture
- **Documentation**: Complete rewrite covering all features and options

### Documentation

- **Complete README overhaul**: Comprehensive update documenting all 22 available themes, all configuration options, Clock Mode features, and layout customization options
- **CHANGELOG expansion**: Added detailed changelog entries for all versions from 1.1.31 to 2.1.37, organized by development stages
- **Configuration documentation**: Fully documented Clock Mode options (time separator, date format, day of week)
- **Layout documentation**: Complete documentation of name and unit positioning, alignment, rotation, and font size options
- **Animation documentation**: Added Fast Speed option documentation

---

## Etap 3: Final Polish & Documentation (2.1.x)

### 2.1.32 (2025-12-08)

#### Documentation

- **Complete README update**: Added all 22 available themes to documentation with descriptions and use cases:

  - Aviation themes (Departure, Cockpit, Tarmac)
  - Swiss SBB themes (Black, White, Blue)
  - iOS themes (Light, Dark)
  - Specialty themes (Wood, Red 3D, Blue Glass, Rainbow, Newspaper)

- **Configuration options**: Documented all Clock Mode options:

  - Time separator options (Colon, Dot, Dash, Space, None)
  - Date format options (DD/MM/YYYY, MM/DD/YYYY, YYYY-MM-DD, DD.MM.YYYY)
  - Day of week display option

- **Layout options**: Documented name and unit positioning, alignment, rotation, and font size options

- **Animation options**: Added Fast Speed option documentation

- **Data options**: Documented value aggregation, main content display modes, and auto-fit functionality

---

## Etap 2: Theme Expansion & Visual Enhancements (1.2.x - 2.0.x)

### 2.0.0 (2025-12-04)

#### Features

- **Major Theme Expansion**: Added 13 new professional themes bringing total to 22 themes:

  - **Aviation Collection** (3 themes):

    - `aviation-departure`: Classic airport board style with yellow text (`#f7d100`) on black background, uses Oswald font
    - `aviation-cockpit`: Technical instrument style with cyan text (`#00ffcc`) on dark gray, uses Share Tech Mono font
    - `aviation-tarmac`: Orange/amber high-visibility style (`#fdcb6e`) for ground operations

  - **Swiss SBB Collection** (3 themes):

    - `swiss-sbb-black`: Black background with white text
    - `swiss-sbb-white`: White background with black text
    - `swiss-sbb-blue`: Dark blue with red border (added in 1.2.0)

  - **iOS Collection** (2 themes):

    - `ios-light`: Apple iOS light mode style with white background
    - `ios-dark`: Apple iOS dark mode style with dark background

  - **Specialty Themes** (5 themes):

    - `wood`: Natural wooden texture with brown tones
    - `red-3d`: Red 3D gradient style for alerts/warnings
    - `blue-glass`: Blue-tinted glass effect with transparency
    - `rainbow`: Colorful gradient display with rainbow effect
    - `newspaper`: Halftone newspaper print style with vintage look

#### Improvements

- **Font System**: Updated logo and theme fonts to use system fonts for improved cross-platform compatibility

  - Aviation themes automatically load Google Fonts (Oswald, Share Tech Mono) when available
  - Graceful fallback to system fonts for offline/air-gapped environments

- **Theme Organization**: Better categorization and naming of themes for easier discovery

- **Visual Polish**: Enhanced gradients, shadows, and effects across all new themes

### 1.2.0 (2025-12-11)

#### Features

- **Swiss SBB Blue Theme**: Added official Swiss railway blue theme (`swiss-sbb-blue`) with:

  - Dark blue background (`#0B1E3C`)
  - White text
  - Red border accent (`#EB0000`) matching SBB branding
  - Gradient effects for depth

#### Improvements

- **Theme Refinements**: Improved visual consistency across all themes
- **Theme Organization**: Better categorization of themes in the selector

---

## Etap 1: Security & Architecture Overhaul (1.1.32)

#### 1.1.32 (2025-12-11)

#### Security

- **XSS Protection**: Removed XSS vulnerabilities by replacing `innerHTML` (lines 328, 584 in old flip-engine) with React rendering
- **Character Escaping**: Added character escaping in FlipDigit to only allow safe characters (numbers, letters, and specific symbols)
- **Safe DOM Updates**: All DOM updates now use React's safe rendering mechanisms

#### CSP Compatibility

- **Removed Google Fonts**: Removed Google Fonts `@import` statements (lines 330-331) that violated Content Security Policy
- **System Font Fallbacks**: Replaced with system font fallbacks (e.g., `-apple-system`, `BlinkMacSystemFont`, `'Segoe UI'`, `sans-serif`)
- **Local Fonts Only**: All fonts now use local/system fonts that work with strict CSP policies

#### Architecture Overhaul

- **React Migration**: Complete migration from custom elements to React components

  - Created `FlipDigit.tsx` — React component for individual flip digits with animation logic
  - Created `FlipDisplay.tsx` — Component managing multiple digits
  - Removed custom element (`FlipSensorCard`) in favor of React components
  - Updated `FlipBoard.tsx` to use the new React components

- **Styling Modernization**:

  - Converted all styles to Emotion CSS-in-JS (Grafana best practice)
  - Removed shadow DOM and inline styles
  - All themes preserved with the same visual appearance

- **Code Cleanup**:

  - Removed deprecated `src/core/flip-engine.ts` (754 lines removed)
  - Removed duplicate `src/core/flip-engine.tx` file
  - Improved code organization and maintainability

#### Impact

- **Security**: Plugin is now safe from XSS attacks and CSP-compliant
- **Maintainability**: React-based architecture is easier to maintain and extend
- **Performance**: Better React optimization and rendering performance
- **Compatibility**: Works in environments with strict CSP policies

## 1.1.31 (2025-11-30)

### Maintenance

- Fixed incorrect path for `grafana/plugin-actions/build-plugin` in release workflow (reverted to explicit tag path).

## 1.1.30 (2025-11-30)

### Maintenance

- Reverted to official `grafana/plugin-actions/build-plugin` workflow, now that signing issues are resolved via CLI flags.
- Kept `softprops/action-gh-release` for artifact publishing.

## 1.1.29 (2025-11-30)

### Maintenance

- Official release (removed `-beta` suffix).
- Stabilized build workflow with manual signing and packaging steps.

## 1.1.28-beta.26 (2025-11-30)

### Maintenance

- Fixed release artifact naming by using git tag version instead of parsing JSON.
- Marked release as full release (not prerelease).

## 1.1.28-beta.25 (2025-11-30)

### Maintenance

- Replaced opaque `package-plugin` action with manual `zip` command to ensure artifact creation and correct naming for release upload.

## 1.1.28-beta.24 (2025-11-30)

### Maintenance

- Switched to `softprops/action-gh-release` for reliable GitHub Release creation.

## 1.1.28-beta.23 (2025-11-30)

### Maintenance

- Added manual MD5 checksum generation step to release workflow.

## 1.1.28-beta.22 (2025-11-30)

### Maintenance

- Corrected artifact path pattern for GitHub Release upload (checking root directory instead of `dist/`).

## 1.1.28-beta.21 (2025-11-30)

### Maintenance

- Added GitHub Release step to upload plugin artifacts (.zip and .md5) to the release page.

## 1.1.28-beta.20 (2025-11-30)

### Maintenance

- Added `id-token: write` and `attestations: write` permissions to workflow for build provenance attestation.

## 1.1.28-beta.19 (2025-11-30)

### Maintenance

- Removed `rootUrls` from `plugin.json` to satisfy plugin validator (using command line flag for signing instead).
- Cleaned up build workflow.

## 1.1.28-beta.18 (2025-11-30)

### Maintenance

- Added `--rootUrls` flag to `yarn sign` command as a fallback for JSON configuration.

## 1.1.28-beta.17 (2025-11-30)

### Maintenance

- Fixed GitHub Action path for `package-plugin`.
- Added forced injection of `rootUrls` into `dist/plugin.json` before signing to ensure field presence.

## 1.1.28-beta.16 (2025-11-30)

### Maintenance

- Switched to manual build workflow in GitHub Actions to debug signing issues.

## 1.1.28-beta.15 (2025-11-30)

### Maintenance

- Added debug step to CI to verify `plugin.json` content.

## 1.1.28-beta.14 (2025-11-30)

### Maintenance

- Bump version to retry build process.

## 1.1.28-beta.13 (2025-11-30)

### Maintenance

- Added `rootUrls` to `plugin.json` to fix signing error for private plugin token.

## 1.1.28-beta.12 (2025-11-30)

### Maintenance

- Re-trigger release build with correct secrets configuration.

## 1.1.28-beta.11 (2025-11-30)

### Maintenance

- Fixed Github Action reference for `grafana/plugin-actions/build-plugin`.

## 1.1.28-beta.10 (2025-11-30)

### Maintenance

- Fixed yarn registry configuration to resolve installation issues in CI.
- Updated workflow configurations.

## 1.0.0 (2025-11-30)

### Features

- **Smart Flip Logic**: Numbers spin fast using a numeric drum, while text uses the full alphanumeric drum for realistic effect.
- **Animation Easing**: Added physics-based easing (acceleration/deceleration) for long flip sequences.
- **New Themes**: Added `Matrix` (digital rain), `Cyberpunk` (CRT effect), `Airport`, `Mechanical`, `Glass`, and `Neon` styles.
- **Data Aggregation**: Added selector for Last, First, Min, Max, Mean, Sum, Count value reduction.
- **Display Content**: Option to show Value, Name, or both directly on the flaps (e.g. "London 20").
- **Performance**: Added `will-change: transform` for GPU acceleration and optimized React re-renders.
- **Accessibility**: Added ARIA labels and roles for screen readers.

### Fixes

- **Thresholds**: Fixed conflict where themes overrode Grafana threshold colors (removed `!important` from styles).
- **Text Formatting**: Fixed issue where "Name + Value" ignored rounding settings (now formats numbers before combining).
- **Visual Glitches**: Fixed "TTkyo" glitch by preventing animation on disconnected DOM elements.
- **Spacing**: Added proper spacing for "Name + Value" display mode.
- **Memory**: Added cleanup logic to stop animations when panel is unmounted.
- **Timestamp**: Fixed logic to prioritize value fields over time fields.
