Concepts overview

A Theme Manager run starts from a seed color or included custom definition. Material Design 3 generation resolves light and dark semantic schemes, then each registered adapter formats the roles for its target.

Generation writes adapter-owned generated sources. Selection chooses one active theme family and applies a variant. Application reuses that active family for later light/dark mode changes. Both live paths update live destinations such as stable imports, copied files, or editor pointers. The registry is the authority for which adapters participate in each phase.

• Theme sources explain how the CLI chooses an input.
• Semantic colors explain the shared roles adapters translate.
• Generation, selection, and application explains the three responsibilities.