diff --git a/example/themes/README.md b/example/themes/README.md
index 8572222a..0102efe7 100644
--- a/example/themes/README.md
+++ b/example/themes/README.md
@@ -1,7 +1,19 @@
 # Themes
-Please make sure that the theme name and the file name are the same (+`.kdl`).
+
+Themes can contain different flavors in one file, or can be created as individual files.
 
 Example:
 
-- theme: gruvbox
-- filename: `gruvbox.kdl`
+```
+gruvbox.kdl
+├─ gruvbox-light
+└─ gruvbox-dark
+
+or
+
+gruvbox-light.kdl
+└─ gruvbox-light
+
+gruvbox-dark.kdl
+└─ gruvbox-dark
+```