5. BRT Live Customizer
BRT Customizer Interface
Last Updated: December 31, 20251. Understanding the Customizer Interface The customizer screen is split into two main columns: Left Column — Settings Panel Theme-specific options (colors, layout, typography, images, etc.) Extra CSS editor Enable / disable custom CSS Save, restore, and backup actions Right Column — Live Preview Real Redmine page loaded inside an iframe Updates instantly as you...
Backup & Restore: Safely Managing Your Custom Styles
Last Updated: December 31, 2025When customizing a Redmine theme, having a safe way to save, restore, and reuse your settings is essential.BRT Customizer includes a built-in backup system designed to keep your work protected at all times. Why Backups Matter Theme customization is usually an iterative process: You test visual changes You refine colors and layout You adjust branding...
Using Official Skins with BRT Customizer
Last Updated: December 31, 2025BRT Customizer allows you to easily apply and adjust the official Zenmine and Boostmine skins, designed to give your Redmine a polished and professional appearance in seconds. These skins are pre-designed visual styles, created by the theme authors, and optimized for real-world Redmine usage. What Are Skins? Skins are ready-made visual configurations that define: Carefully...
Installing BRT Customizer
Last Updated: December 31, 2025BRT Customizer is designed to be easy to install and fully compatible with standard Redmine installations.No manual configuration or file editing is required after installation. Requirements and Compatibility BRT Customizer is compatible with: Redmine 3.x and above Including Redmine 4, 5 and 6 It works with both classic and modern Redmine installations. Supported Environments The...
Troubleshooting: The Plugin Does Not Appear in the Plugins List
Last Updated: December 31, 2025Possible causes: The plugin folder name is incorrect The plugin is not placed in the correct directory Redmine was not restarted How to fix it: Ensure the folder name is exactly:brt_customizer Verify the path is:/redmine/plugins/brt_customizer Restart Redmine and reload the page Check log/production.log for startup errors
Troubleshooting: “BRT Customizer” Menu Is Missing
Last Updated: December 31, 2025Possible causes: You are not logged in as an administrator Redmine was not restarted after installation How to fix it: Log in with an administrator account Restart Redmine Go to Administration → Plugins and confirm the plugin is listed
Troubleshooting: Zenmine or Boostmine Is Not Detected
Last Updated: December 31, 2025Possible causes: The theme folder name was changed The theme is not installed in the correct location The theme is not active How to fix it: Ensure the theme folder name contains: zenmine or boostmine Activate the theme via:Administration → Settings → Display Reload BRT Customizer after activating the theme
Troubleshooting: No Zenmine or Boostmine Theme Detected
Last Updated: December 31, 2025If BRT Customizer shows a message indicating that no compatible theme was detected, it means the plugin could not find an active Zenmine or Boostmine theme. This can happen for two main reasons. Possible Cause 1: The Theme Is Not Installed BRT Customizer only works with: Zenmine Boostmine If neither theme is installed, the customizer...
Troubleshooting: Live Preview Does Not Update
Last Updated: December 31, 2025Possible causes: JavaScript error in the browser Browser extensions interfering Cached assets How to fix it: Reload the page Try an incognito/private window Disable browser extensions temporarily Check the browser console for JavaScript errors
Troubleshooting: Changes Are Not Applied After Saving
Last Updated: December 31, 2025Possible causes: “Apply BRT Customizer settings” is disabled The wrong theme is active The page was not saved How to fix it: Ensure “Apply BRT Customizer settings” is checked Confirm Zenmine or Boostmine is the active theme Click Save and reload any Redmine page
Troubleshooting: Restore Backup / Skin Does Not Work
Last Updated: December 31, 2025Possible causes: Invalid or corrupted JSON file Skin belongs to a different theme (Zenmine vs Boostmine) How to fix it: Make sure the file is a valid JSON backup Restore Zenmine skins only in Zenmine, and Boostmine skins only in Boostmine Re-download the skin file if needed
Troubleshooting: After Uninstalling the Plugin, the Theme Looks Normal
Last Updated: December 31, 2025This is expected behavior. BRT Customizer: Does not modify theme files Does not alter Redmine core Applies all changes dynamically Removing the plugin automatically restores the original theme appearance or the customized version, if you had made any changes to the theme customize.css file.
Split View (Gmail-style) for Issue Lists
Last Updated: March 7, 2026BRT Customizer now includes a new Split View option (Gmail-style). When enabled, users can browse their issue lists with a two-panel layout: a list on the left and the issue page on the right, so they can review issues faster without constantly opening new pages. How it works 1) Admin enables it in Live Customizer From...
Scheduled Global Frontend Notice
Last Updated: March 7, 2026Publish a scheduled global frontend notice in Redmine with audience targeting, notice type and start/end timing.
Quick Recap Popup on Task Hover
Last Updated: March 7, 2026Show a Quick Recap popup on issue hover with recent changes, last note and quick actions, without opening the task.
Sticky Header for Issue Lists
Last Updated: March 7, 2026Keep issue list column headers visible while scrolling long Redmine lists with a user-enabled sticky header.
Reorder Columns in the Issue List
Last Updated: March 7, 2026Let users drag and reorder issue list columns, so each Redmine view matches their own workflow.
Resize Columns in the Issue List
Last Updated: March 7, 2026Let users resize issue list columns in Redmine and keep the widths they prefer for each working view.
Assigned Issues Badge on the Top Menu
Last Updated: March 7, 2026Show a top-menu badge with the number of open issues assigned to the current user, plus a quick popup with assigned tasks.
Hide the Help Link from the Top Menu
Last Updated: March 7, 2026Hide the redmine.org/guide Help link from the Redmine top menu for a cleaner, more controlled header in Zenmine or Boostmine.
Compact View for Issue Lists (Zenmine)
Last Updated: March 7, 2026Add an optional compact issue list layout in Zenmine, so users can see more tasks on screen and enable it individually from My account.
Hot Ticket Temperature Indicator
Last Updated: March 18, 2026Add a hot ticket temperature indicator that highlights active or urgent issues directly in the Redmine issue list.