From eca164fa3e87ab798b0bb3bf5e454fa6a373fe93 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Sat, 7 Feb 2026 16:39:56 +0000
Subject: [PATCH] Add usage instructions to custom color palette option
 descriptions

Co-authored-by: jmiller-moko <230051081+jmiller-moko@users.noreply.github.com>
---
 src/language/en-GB/tpl_mokocassiopeia.ini | 2 ++
 src/language/en-US/tpl_mokocassiopeia.ini | 2 ++
 src/templates/templateDetails.xml         | 4 ++--
 3 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/src/language/en-GB/tpl_mokocassiopeia.ini b/src/language/en-GB/tpl_mokocassiopeia.ini
index d600b9c..76f4a66 100644
--- a/src/language/en-GB/tpl_mokocassiopeia.ini
+++ b/src/language/en-GB/tpl_mokocassiopeia.ini
@@ -77,7 +77,9 @@ TPL_MOKOCASSIOPEIA_COLOR_NAME_ALTERNATIVE="Alternative"
 TPL_MOKOCASSIOPEIA_COLOR_NAME_CUSTOM="Custom"
 ; New labels for Theme tab dropdowns
 TPL_MOKOCASSIOPEIA_COLOR_LIGHT_NAME_LABEL="Light color palette"
+TPL_MOKOCASSIOPEIA_COLOR_LIGHT_NAME_DESC="Select a color palette for light mode. To use Custom, copy the template file from <code>templates/colors_custom.css</code> to <code>media/templates/site/mokocassiopeia/css/colors/light/colors_custom.css</code> and customize the CSS variables to match your brand."
 TPL_MOKOCASSIOPEIA_COLOR_DARK_NAME_LABEL="Dark color palette"
+TPL_MOKOCASSIOPEIA_COLOR_DARK_NAME_DESC="Select a color palette for dark mode. To use Custom, copy the template file from <code>templates/colors_custom.css</code> to <code>media/templates/site/mokocassiopeia/css/colors/dark/colors_custom.css</code> and customize the CSS variables to match your brand."
 
 ; ===== Theme tab (core feature strings) =====
 TPL_MOKO_THEME_FIELDSET="Theme"
diff --git a/src/language/en-US/tpl_mokocassiopeia.ini b/src/language/en-US/tpl_mokocassiopeia.ini
index 96386ab..5b97e57 100644
--- a/src/language/en-US/tpl_mokocassiopeia.ini
+++ b/src/language/en-US/tpl_mokocassiopeia.ini
@@ -77,7 +77,9 @@ TPL_MOKOCASSIOPEIA_COLOR_NAME_ALTERNATIVE="Alternative"
 TPL_MOKOCASSIOPEIA_COLOR_NAME_CUSTOM="Custom"
 ; New labels for Theme tab dropdowns
 TPL_MOKOCASSIOPEIA_COLOR_LIGHT_NAME_LABEL="Light color palette"
+TPL_MOKOCASSIOPEIA_COLOR_LIGHT_NAME_DESC="Select a color palette for light mode. To use Custom, copy the template file from <code>templates/colors_custom.css</code> to <code>media/templates/site/mokocassiopeia/css/colors/light/colors_custom.css</code> and customize the CSS variables to match your brand."
 TPL_MOKOCASSIOPEIA_COLOR_DARK_NAME_LABEL="Dark color palette"
+TPL_MOKOCASSIOPEIA_COLOR_DARK_NAME_DESC="Select a color palette for dark mode. To use Custom, copy the template file from <code>templates/colors_custom.css</code> to <code>media/templates/site/mokocassiopeia/css/colors/dark/colors_custom.css</code> and customize the CSS variables to match your brand."
 
 ; ===== Theme tab (core feature strings) =====
 TPL_MOKO_THEME_FIELDSET="Theme"
diff --git a/src/templates/templateDetails.xml b/src/templates/templateDetails.xml
index c2a8a1e..f269019 100644
--- a/src/templates/templateDetails.xml
+++ b/src/templates/templateDetails.xml
@@ -189,12 +189,12 @@
 
 				<!-- Variables & Palettes -->
 				<field name="theme_sep_vars" type="spacer" label="Variables &amp; Palettes" hr="false" class="text fw-bold" />
-				<field name="colorLightName" type="list" label="TPL_MOKOCASSIOPEIA_COLOR_LIGHT_NAME_LABEL" default="colors_standard">
+				<field name="colorLightName" type="list" label="TPL_MOKOCASSIOPEIA_COLOR_LIGHT_NAME_LABEL" description="TPL_MOKOCASSIOPEIA_COLOR_LIGHT_NAME_DESC" default="colors_standard">
 					<option value="colors_standard">TPL_MOKOCASSIOPEIA_COLOR_NAME_STANDARD</option>
 					<option value="colors_alternative">TPL_MOKOCASSIOPEIA_COLOR_NAME_ALTERNATIVE</option>
 					<option value="colors_custom">TPL_MOKOCASSIOPEIA_COLOR_NAME_CUSTOM</option>
 				</field>
-				<field name="colorDarkName" type="list" label="TPL_MOKOCASSIOPEIA_COLOR_DARK_NAME_LABEL" default="colors_standard">
+				<field name="colorDarkName" type="list" label="TPL_MOKOCASSIOPEIA_COLOR_DARK_NAME_LABEL" description="TPL_MOKOCASSIOPEIA_COLOR_DARK_NAME_DESC" default="colors_standard">
 					<option value="colors_standard">TPL_MOKOCASSIOPEIA_COLOR_NAME_STANDARD</option>
 					<option value="colors_alternative">TPL_MOKOCASSIOPEIA_COLOR_NAME_ALTERNATIVE</option>
 					<option value="colors_custom">TPL_MOKOCASSIOPEIA_COLOR_NAME_CUSTOM</option>