Add color configuration guide to themes

[mintlify]

Added comprehensive color configuration documentation to the themes page. This includes explanations of color properties, common patterns, testing steps, troubleshooting guides, and theme-specific behavior to help users resolve color-related issues.

Files changed

• customize/themes.mdx - Added new "Understanding color configuration" section with detailed guidance on using primary, light, and dark color properties

---

Note

Low Risk
Documentation-only change confined to customize/themes.mdx, with no runtime logic or API behavior changes.

Overview
Adds a new “Understanding color configuration” section to customize/themes.mdx documenting how colors.primary, colors.light, and colors.dark in docs.json map to accents/buttons across light and dark modes.

Includes example configurations, guidance on testing (light/dark, WCAG contrast, hover states), troubleshooting common visibility issues, and a brief per-theme overview of how the color fields tend to be applied.

^{Written by Cursor Bugbot for commit d3d2f24. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is OFF. To automatically fix reported issues with Cloud Agents, enable Autofix in the Cursor dashboard.}

[cursor]

Escaped quotes in className break MDX rendering

High Severity

The className attribute on this div uses escaped quotes (\") instead of regular quotes ("), unlike every other className in the file. This will cause the MDX parser to either fail or render the element incorrectly, effectively hiding the entire new color configuration section from users.