5.0.0 - Material Expressive

Material Expressive

In May of 2025 Google announced that Android 16 includes a major update to Material Design 3 - Material 3 Expressive. Material Expressive introduces updated dynamic color themes, component designs, and animations. I'm proud to say that this theme and its companion module have been updated to follow the updated Material 3 Expressive specifications.

This update requires at least Material You Utilities version 2.0.0 to function properly. Most changes are made in the companion module, but this update includes new and updated material design system tokens for expressive colors and animations.

While this beta is feature complete, it will remain as a pre-release until Android 16 QPR1 is released with its Material Expressive redesigns. Until then any feedback regarding the module and theme beta should go in the Material Expressive issue thread Nerwyn/material-you-utilities#13.

Animations

Material Expressive comes with a new motion physics system. Transitions now have more bounce and will slightly overshoot their final values before stopping. These transitions have been added to the theme variables for use by the companion module.

Breaking Changes

The explicit light and dark versions of the theme have been removed. Instead CSS files have been provided that can be applied as frontend resources or using the companion module which will force the theme to always be in light or dark mode.

Full Changelog: 4.0.9...5.0.0-beta.012

4.0.9 - Material You Unlimited

Changes in 4.0.9

• Add automation trace colors #103.

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Patch Version Changes

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.
• Horizontal overflow fix for certain dialogs.
• Input chip styles.
• Navigation bar, rail, and drawer fixes for 2025.5.0 #87.
• 2025.5.0 - obsolete old paper elements font attributes and add new Home Assistant ones.
• Fix label badge text color
• Add missing slider active track color.
• Add automation trace colors #103.

Full Changelog: 3.1.5...4.0.9

4.0.8 - Material You Unlimited

Changes in 4.0.8

• Add missing slider active track color.

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Patch Version Changes

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.
• Horizontal overflow fix for certain dialogs.
• Input chip styles.
• Navigation bar, rail, and drawer fixes for 2025.5.0 #87.
• 2025.5.0 - obsolete old paper elements font attributes and add new Home Assistant ones.
• Fix label badge text color
• Add missing slider active track color.

Full Changelog: 3.1.5...4.0.8

4.0.7 - Material You Unlimited

Changes in 4.0.7

• Fix label badge text color

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Patch Version Changes

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.
• Horizontal overflow fix for certain dialogs.
• Input chip styles.
• Navigation bar, rail, and drawer fixes for 2025.5.0 #87.
• 2025.5.0 - obsolete old paper elements font attributes and add new Home Assistant ones.
• Fix label badge text color

Full Changelog: 3.1.5...4.0.7

4.0.6 - Material You Unlimited

Changes in 4.0.6

• 2025.5.0 - obsolete old paper elements font attributes and add new Home Assistant ones.

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Patch Version Changes

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.
• Horizontal overflow fix for certain dialogs.
• Input chip styles.
• Navigation bar, rail, and drawer fixes for 2025.5.0 #87.
• 2025.5.0 - obsolete old paper elements font attributes and add new Home Assistant ones.

Full Changelog: 3.1.5...4.0.6

4.0.5 - Material You Unlimited

Changes in 4.0.5

• Navigation bar, rail, and drawer fixes for 2025.5.0 #87.

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Patch Version Changes

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.
• Horizontal overflow fix for certain dialogs.
• Input chip styles.
• Navigation bar, rail, and drawer fixes for 2025.5.0 #87.

Full Changelog: 3.1.5...4.0.5

4.0.4 - Material You Unlimited

Changes in 4.0.4

• Input chip styles.

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Patch Version Changes

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.
• Horizontal overflow fix for certain dialogs.
• Input chip styles.

Full Changelog: 3.1.5...4.0.4

4.0.3 - Material You Unlimited

Changes in 4.0.3

• Horizontal overflow fix for certain dialogs.

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Patch Version Changes

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.
• Horizontal overflow fix for certain dialogs.

Full Changelog: 3.1.5...4.0.3

4.0.2 - Material You Unlimited

Changes in 4.0.2

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Patch Version Changes

• Added optional CSS resource files and instructions on how to use them for alternate card styles.
• Removed transparent card variants of theme, as transparent card styles can now be applied using CSS resources or card-mod.

Full Changelog: 3.1.5...4.0.1

4.0.0 - Material You Unlimited

⚠️ HUGE Breaking Changes ⚠️

Do not upgrade until you've read the release notes.

Material You, Unlimited

You now have even more control of how your Material You theme is generated! Component style upgrades now work everywhere in Home Assistant and are much more efficient. They no longer use card-mod and require a new and improved companion JavaScript module. By itself, this theme no longer modifies Home Assistant components.

The companion JavaScript module has been moved into its own repository. This was done to ease updates and installation of the module as it can now be managed through HACS (as a custom repository). The companion JavaScript module also not only handles color theme generation, but component style upgrades as well. Because of this I expect that repository to receive more updates than this one, as this theme references values generated by the companion JavaScript module. You must follow the first time installation instructions in the companion JavaScript module repository.

This theme no longer uses card-mod for component style upgrades. Component style upgrades have been moved to the companion JavaScript module, which instead "monkey patches" the lifecycle methods of custom element constructors to include the custom styles. This allows these styles to be applied everywhere in Home Assistant and should fix the performance issues many users are experiencing #49.

The theme file name has been changed from material_rounded.yaml to material_you.yaml. This was done to help mitigate caching and install issues with HACS downloading old versions of the theme YAML, especially pre-release versions. When updating to version 4, you should uninstall this theme using HACS and then reinstall it. If you are still seeing Material Rounded theme variants in your themes folder, delete the Material Rounded folder and YAML file from your themes folder. There should just be a Material You folder and YAML file instead. You may have to run the action frontend.reload_themes using the actions developer tool if old theme names still appear.

The domains and names of the entities used to customize the theme have been changed. They are now input text/select/number entities and now are accessible and creatable via a configuration panel added to the companion JavaScript module. User specific entities now only use the user ID instead of the username.

You should delete the old color only JavaScript module file from both frontend resources and modules before installing the new companion JavaScript module.

⚠️ Deprecations and Obsoletions ⚠️

Material Rounded No More

The legacy Material Rounded theme has been removed from this repository. This was done to greatly simplify theme development and maintenance, as all colors are now derived from the Material You theme generated palette. You can still use this theme's colors by adding this CSS file as a frontend resource stylesheet. Note that custom themes applied by the companion JavaScript module will overwrite this, so you cannot use custom colors with resource stylesheets.

No More No Mod

Because this theme no longer uses card-mod, the No Mod versions of the theme have been removed. The style upgrades require the new companion JavaScript module. You can still disable the Material Design 3 component upgrades in the configuration UI using the Style Upgrades toggle in the companion JavaScript module configuration panel. You can also opt not to use the companion JavaScript module and use a frontend resource stylesheet generated using Material Theme Builder instead.

Entity Name Changes

Previous versions of this theme used sensor domain helper entities for user defined base colors. These sensors have been obsoleted and will no longer work. The companion JavaScript module now uses input_text, input_select, and input_number entities for base color, scheme name, and contrast level, respectively. The format of these helper entity names has also changed to input_text.material_you_base_color_uuid, without support for user name helpers.

You shouldn't have to worry about creating these helpers yourself, as the configuration UI will create all of them for you. If you are using custom logic to set this input, you should switch to an automation like mentioned above.

Full Changelog: 3.1.5...4.0.0