diff --git a/src/ui/web/css/themes/README.md b/src/ui/web/css/themes/README.md
new file mode 100644
index 00000000..9078da14
--- /dev/null
+++ b/src/ui/web/css/themes/README.md
@@ -0,0 +1,7 @@
+things that go in the theme:
+ - margin specialization
+ - padding
+ - colors (foreground, background, border, ...)
+ - border-radius
+ - font faces, weights and sizes
+ - alignment