From 71c115ca88e66da6a40a09ef17e6b91bb0c92625 Mon Sep 17 00:00:00 2001
From: jensjvh <43621451+jensjvh@users.noreply.github.com>
Date: Wed, 22 Jul 2026 16:43:07 +0300
Subject: [PATCH] Add instructions for using the dark theme selector

---
 style_aplus/css.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/style_aplus/css.rst b/style_aplus/css.rst
index 73ef330..ed0ba4a 100644
--- a/style_aplus/css.rst
+++ b/style_aplus/css.rst
@@ -172,3 +172,17 @@ be copied to ``_static`` before recompiling the course! For faster CSS design,
 one might want to try the `Firefox Developer Edition
 <https://www.mozilla.org/en-US/firefox/developer/>`_ which has a builtin
 CSS editor.
+
+CSS styles for dark theme
+-------------------------
+
+To add dark theme specific custom CSS styles, you can use the attribute selector ``[data-bs-theme=dark]``. For example:
+
+.. code-block:: css
+
+   [data-bs-theme=dark] h2 {
+       color: white;
+   }
+
+You should consider using this whenever you change colours with your custom CSS or add new elements to your course which
+might conflict with the dark theme.