From 6befb685b035096e16698bb8d8e9aa15045ff104 Mon Sep 17 00:00:00 2001
From: "Maarten A. Breddels" <maartenbreddels@gmail.com>
Date: Fri, 23 Feb 2024 14:16:02 +0100
Subject: [PATCH] Add docs

---
 docs/usage.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/usage.rst b/docs/usage.rst
index d22b91e6..95ab8165 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -485,6 +485,18 @@ Available theme properties:
 - warning
 - anchor
 
+If :code:`dark` is set to None (the default), we use the setting from Jupyter Lab, VS Code or Google Colab.
+In Jupyter notebook classic, or other unrecognized systems we always use the light theme.
+When running in `Solara server <https://github.com/widgetti/solara/>`_, dark mode is
+determined by how the `Solara server <https://solara.dev/docs/understanding/solara-server>`_ is configured.
+
+In all cases, the `dark_effective` attribute can be used to know if the dark theme is used.
+
+.. code-block:: python
+
+    if v.theme.dark_effective:
+        ...
+
 Summary
 -------