Skip to content

docs(dms): document the Source Color setting - #129

Open
Conava wants to merge 1 commit into
AvengeMedia:masterfrom
Conava:source-color-extraction
Open

docs(dms): document the Source Color setting#129
Conava wants to merge 1 commit into
AvengeMedia:masterfrom
Conava:source-color-extraction

Conversation

@Conava

@Conava Conava commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

Documents the Source Color setting. Pairs with a DankMaterialShell PR I'm opening right after this one.

DMS builds its whole palette from one color extracted from the wallpaper, and until now always took matugen's most dominant candidate with no way to change it. The new setting allows choosing between multiple options which color is selected as a seed for the generated color theme.

Adds a ## Source Color section to Application Theming, between the intro and Disabling Matugen. It documents all seven values with the matugen flag each maps to, notes that Colorful is computed by DMS and works with any matugen version while the five --prefer modes need matugen 4.1 or newer, and states the near-black-wallpaper trade-off up front rather than leaving users to find it.

DMS seeds its palette from one color extracted from the wallpaper, and
until now always took matugen's most dominant candidate. The new Source
Color setting picks which candidate wins, so a warm wallpaper no longer
has to produce a cold palette.

Documents all seven values with the matugen flag each maps to, notes
that Colorful works with any matugen version while the --prefer modes
need matugen 4, and states the near-black wallpaper trade-off up front
rather than leaving users to find it.
Copilot AI lite review requested due to automatic review settings August 8, 2026 15:32

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the DankMaterialShell docs to explain the new Source Color setting that controls which wallpaper-derived color seeds matugen’s generated palette, including option semantics, CLI flag mappings, version requirements, and where to find the setting in the UI.

Changes:

  • Adds a new ## Source Color section to the Application Theming page.
  • Documents all seven Source Color values, including how each maps to matugen flags (or when no flag applies).
  • Notes matugen version requirements for --prefer modes and the fallback behavior on older versions.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants