piitaya / lovelace-mushroom

🍄 Mushroom [![hacs][hacs-badge]][hacs-url] [![release][release-badge]][release-url] ![downloads][downloads-badge] ![build][build-badge] [![translations][translations-badge]][weblate-url] What is mushroom ? Mushroom is a collection of cards for [Home Assistant][home-assistant] Dashboard UI. Mushroom mission is to propose easy to use components to build your [Home Assistant][home-assistant] dashboard. Features • 🛠 Editor for **all cards** and and **all options** (no need to edit ) • 😍 Icon picker • 🖌 Color picker • 🚀 0 dependencies : no need to install another card. • 🌈 Based on Material UI colors • 🌓 Light and dark theme support • 🎨 Optional theme customization • 🌎 Internationalization The goal of Mushroom is not to provide custom card for deep customization. You can use the excellent [UI Lovelace Minimalist][ui-lovelace-minimalist] and [Button card][button-card] plugins for this. Installation HACS Mushroom is available in [HACS][hacs] (Home Assistant Community Store). Use this link to directly go to the repository in HACS _or_ • Install HACS if you don't have it already • Open HACS in Home Assistant • Search for "Mushroom" • Click the download button. ⬇️ Manual • Download file from the [latest release][release-url]. • Put file into your folder. • Add reference to in Dashboard. There's two way to do that: • **Using UI:** _Settings_ → _Dashboards_ → _More Options icon_ → _Resources_ → _Add Resource_ → Set _Url_ as → Set _Resource type_ as . **Note:** If you do not see the Resources menu, you will need to enable _Advanced Mode_ in your _User Profile_ • **Using YAML:** Add following code to section. Usage All the Mushroom cards can be configured using Dashboard UI editor. • In Dashboard UI, click 3 dots in top right corner. • Click _Edit Dashboard_. • Click Plus button to add a new card. • Find one of the _Custom: Mushroom_ card in the list. Cards Different cards are available for differents entities : • 🚨 Alarm card • 🔔 Chips card • 🌡 Climate card • 🪟 Cover card • 🪄 Entity card • 🕳 Empty card • 💨 Fan card • 💧 Humidifier card • 💡 Light card • 🔒 Lock card • 📺 Media card • 🔢 Number card • 🙋 Person card • 📑 Select card • 🛠 Template card • ✏️ Title card • 📦 Update card • 🧹 Vacuum card Legacy cards Some cards are considered as legacy, are not available in the card picker but you can still use them : • 🛠 Legacy Template card Badges A template badge is available if you're using at least Home Assistant 2024.8. Theme customization Mushroom works without theme but you can add a theme for better experience by installing the Mushroom Themes. If you want more information about themes, check out the official [Home Assistant documentation about themes][home-assitant-theme-docs]. Development server Home assistant demo You can run a demo instance of Home Assistant with docker by running: Once it's done, go to Home Assistant instance http://localhost:8123 and start configuration. Windows Users If you are on Windows, either run the above command in Powershell, or use the below if using Command Prompt: Development In another terminal, install dependencies and run development server: Server will start on port . Build You can build the file in folder by running the build command. Translations If you want to help translating Mushroom, you can translate it directly from your browser using [Weblate][weblate-url]. Maintainer steps to add a new language • To be compatible with Home Assistant, language tags have to follow BCP 47. A list of most language tags can be found here: IANA subtag registry. Examples: , , . • Create a new file with your language code in the translation folder. Examples: . • Import your file into the and add your language in the record. • Don't forget to test locally with the development server by choosing the language with the Home Assistant UI in your profile. Troubleshooting I don't see the last changes • Check that your Home Assistant version is the latest. Some new Mushroom features can only be visible for the latest Home Assistant version. • Check that you have the latest Mushroom version on HACS • Check that you have the latest Mushroom version by checking the browser console • Clear your cache : • delete mushroom resources (https://my.home-assistant.io/redirect/lovelace_resources/) • uninstall Mushroom from HACS • reinstall Mushroom from HACS My card mod configuration doesn't work. Help about card mod configuration is not provided in this repository. More info in the state of card mod support. Credits The design is inspired by [7ahang’s work][7ahang] on Behance and [Ui Lovelace Minimalist][ui-lovelace-minimalist]. [hacs-url]: https://github.com/hacs/integration [hacs-badge]: https://img.shields.io/badge/hacs-default-orange.svg?style=flat-square [release-badge]: https://img.shields.io/github/v/release/piitaya/lovelace-mushroom?style=flat-square [downloads-badge]: https://img.shields.io/github/downloads/piitaya/lovelace-mushroom/total?style=flat-square [build-badge]: https://img.shields.io/github/actions/workflow/status/piitaya/lovelace-mushroom/build.yml?branch=main&style=flat-square [translations-badge]: https://hosted.weblate.org/widget/mushroom/svg-badge.svg [home-assistant]: https://www.home-assistant.io/ [home-assitant-theme-docs]: https://www.home-assistant.io/integrations/frontend/#defining-themes [hacs]: https://hacs.xyz [ui-lovelace-minimalist]: https://ui-lovelace-minimalist.github.io/UI/ [button-card]: https://github.com/custom-cards/button-card [7ahang]: https://www.behance.net/gallery/88433905/Redesign-Smart-Home [release-url]: https://github.com/piitaya/lovelace-mushroom/releases [weblate-url]: https://hosted.weblate.org/engage/mushroom/