Files
rickyandClaude Opus 5.5 53839e4e2e 2026.11.0
A dark mode for Redmine 7 in Gitea's dark theme colours. It follows the device by default, with a
per-user choice in My account (Automatic, Off, On) and a sun/moon toggle in the top bar. The mode is
set before the page paints, and pictures are never inverted.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-02 21:50:45 -05:00

27 lines
1.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Redmine Dark Mode
A dark mode for Redmine 7, in the colours of [Gitea](https://gitea.com)'s dark theme.
## Features
* **Follows the device** by default: dark when the phone or computer is in dark mode, light otherwise, switching as the device does.
* **Per-user choice** in My account › Preferences › Dark mode: Automatic, Off (light) or On (dark).
* **Toggle in the top bar** (sun/moon) switches right away and saves the choice; people not logged in keep theirs in the browser.
* **No flash**: the mode is set before the page paints.
* **Pictures keep their colours**: nothing is inverted. Attachments, thumbnails, images in issues and wiki pages, and the lightbox show the files as they are (transparent pictures get a white backing so dark lines stay visible).
* Works on top of Redmine's own look: Redmine 7 colours almost everything with Open Color variables, which the plugin gives dark values. Code blocks get a dark highlighting style.
* Dark styles for these plugins' hard-coded colours: redmine_qbo (estimate and invoice editor, status badges, reports), redmine_qbo_calendar, redmine_qbo_lineitems, redmine_qbo_reminders, redmine_qbo_vehicles, stopwatch, redmine_easy_notes, redmine_issue_templates and redmine_lightbox.
## Requirements
* Redmine 7.0+
## Installation
1. Clone into `plugins/redmine_dark_mode`.
2. Restart Redmine. There are no migrations.
## Styling another plugin
Dark mode sets `html.dark-mode`. A plugin that colours with Redmine's `--oc-*` variables gets dark mode for free; for hard-coded colours, add rules under `html.dark-mode` to `assets/stylesheets/dark_mode.css` (Plugins section).