diff --git a/quickshell/Modules/DankDash/Overview/CalendarOverviewCard.qml b/quickshell/Modules/DankDash/Overview/CalendarOverviewCard.qml
index e356d2c8b..b9241d3eb 100644
--- a/quickshell/Modules/DankDash/Overview/CalendarOverviewCard.qml
+++ b/quickshell/Modules/DankDash/Overview/CalendarOverviewCard.qml
@@ -574,7 +574,7 @@ Rectangle {
                                     anchors.centerIn: parent
                                     text: dayDate.getDate()
                                     font.pixelSize: Theme.fontSizeSmall
-                                    color: isToday ? Theme.primary : isCurrentMonth ? Theme.surfaceText : Theme.onSurface_38
+                                    color: isToday ? Theme.primary : isCurrentMonth ? Theme.surfaceText : Theme.surfaceVariantText
                                     font.weight: isToday ? Font.Medium : Font.Normal
                                 }
 
diff --git a/quickshell/PLUGINS/THEME_REFERENCE.md b/quickshell/PLUGINS/THEME_REFERENCE.md
index 8ac3cd6b5..cbf89d437 100644
--- a/quickshell/PLUGINS/THEME_REFERENCE.md
+++ b/quickshell/PLUGINS/THEME_REFERENCE.md
@@ -44,13 +44,19 @@ Theme.cornerRadiusLarge // Larger radius
 ### Surface Colors
 ```qml
 Theme.surface
-Theme.surfaceContainerLowest
-Theme.surfaceContainerLow
+Theme.surfaceContainerLowest   // matugen-only (see note)
+Theme.surfaceContainerLow      // matugen-only (see note)
 Theme.surfaceContainer
 Theme.surfaceContainerHigh
 Theme.surfaceContainerHighest
 ```
 
+> **Note:** Not every theme color is consumed by DMS's own UI. `surfaceContainerLowest`,
+> `surfaceContainerLow`, and `backgroundText` are currently unused by DMS components — they
+> exist to complete the Material palette and are exported to matugen templates (VS Code,
+> KDE, Firefox, Zed, etc.). They're still safe to reference in plugins; they just aren't
+> relied on internally.
+
 ### Text Colors
 ```qml
 Theme.onSurface         // Primary text on surface