README.md

April 22, 2026 Β· View on GitHub

Material Home Assistant Logo

🏠 Material Home Assistant

✨Components for Home Assistant

Buy me a coffee

πŸ’Ž Elevate Your Experience

Unlock the full potential of your smart home with advanced professional features.

πŸš€ Pro & Ultimate Versions Available

Choose the perfect plan for your needs and take your automation to the next level.

Get It Now

InstagramΒ Β WebSiteΒ Β WebSiteΒ Β BuyMeACoffeeΒ Β Sponsor

My Home Assistant

Bring the Google Home app experience directly into Home Assistant

A suite of custom cards that implements the Material You design principles for a sleek and modern interface.


🎨 Material Dashboard Card

β˜€οΈ Light Mode

Control Light
πŸŒ™ Dark Mode

Control Dark

πŸŽ›οΈ Material Button Card

β˜€οΈ Light Mode

Control Light
πŸŒ™ Dark Mode

Control Dark

🎚️ Material Slider Card

β˜€οΈ Light Mode

Control Light
πŸŒ™ Dark Mode

Control Dark

🌑️ Material Climate

β˜€οΈ Light Mode

Control Light
πŸŒ™ Dark Mode

Control Dark

πŸ—‚οΈ Material Control

β˜€οΈ Light Mode

Control Light
πŸŒ™ Dark Mode

Control Dark

πŸ’‘ Material Lights

β˜€οΈ Light Mode

Control Light
πŸŒ™ Dark Mode

Control Dark

πŸ”Š Material Media Page

β˜€οΈ Light Mode

Control Light
πŸŒ™ Dark Mode

Control Dark

πŸƒβ€β™‚οΈ Material Dialog Page (Sensor View)

πŸ†• Introduced in version 2.0.0

β˜€οΈ Light Mode

Control Light
πŸŒ™ Dark Mode

Control Dark

And more components...


✨ Key Features

πŸ“±
Mobile-First

UI optimized for mobile devices with intuitive swipe gestures
🎨
Material You

Modern design with dynamic themes and adaptive colors
🧩
Smart Cards

Components for lights, climate, cameras, and more
βš™οΈ
Easy Setup

Simple installation and intuitive configuration

πŸ“¦ Installation

πŸ““ Method 1 – HACS Installation

There are two ways to install the component via HACS: either by clicking the button below or by manually adding the repository.

If you already have HACS installed, you can add the repository directly by clicking this button:

My Home Assistant

Then, simply install the plugin from the HACS interface.

πŸ”§ Option 2 – Manual Installation via HACS

  1. Open HACS in your Home Assistant interface.
  2. Go to Settings β†’ Custom repositories.
  3. Click Add repository and enter the following URL:
https://github.com/giovannilamarmora/lovelace-material-components
  1. Select Plugin as the category.
  2. Click Add to confirm.
  3. Go to HACS β†’ Frontend, search for Google Home Component, then click Install.
  4. Restart Home Assistant to complete the setup.

☁️ Method 2: CDN

The second easiest and fastest way. No download required here either!

  1. Open Home Assistant and go to:

    Settings β†’ Dashboards β†’ Manage Resources
    
  2. Click "Add Resource" and enter:

  • Type: JavaScript module
  • URL:
    https://cdn.jsdelivr.net/gh/giovannilamarmora/lovelace-material-components@master/dist/material-components.js?v=20250626
    
  1. Save and restart Home Assistant.

πŸ’‘ Tip: Change the ?v=YYYYMMDD parameter to force cache refresh after new releases.


πŸ”§ Method 3: Manual Installation

For those who prefer to host files locally.

  1. Download the file material-components.js

  2. Copy the file into the config/www/ folder of Home Assistant:

    config/www/material-components.js
    
  3. Register the resource by going to:

    Settings β†’ Dashboards β†’ Manage Resources
    
  4. Add Resource:

  • Type: JavaScript module
  • URL: /local/material-components.js
  1. Save and restart Home Assistant.

Migration from Google Components

If you were using the old Google Components, you can migrate your dashboards easily.
Check the migration guide here:

πŸ”— Migration Guide


Features

  • Material-style button cards, dialogs, and media overlays.
  • Support for temperature, humidity, motion, and door sensors.
  • Responsive UI for both desktop and mobile.
  • Enhanced customization and theme support.
  • Easy migration from the old Google Components repository.

πŸ“š Full Documentation

πŸ“–

Complete Guide

Everything you need to configure, customize, and get the most out of
Material Home Component

Read the Documentation β†’


Official Community and Discussion β†’
πŸ“‹ You’ll find:
βœ… Detailed setup βœ… Practical examples βœ… System requirements βœ… Customization βœ… Troubleshooting

🧩 Dependencies

Component Description Link
swipe-card (For Dashboard Card) Enables swipe gestures between views GitHub β†’
button-card (For Dashboard Card and Lights Control) Customizable cards for advanced buttons GitHub β†’
card-mod (For Lights Control) Allows you to apply CSS styles to various elements of the Home Assistant frontend. GitHub β†’
auto-entities (For Users Card) Allows you to add all the user present into the house. GitHub β†’
Material Symbol Icons Material Design icon set GitHub β†’
Material You Theme Dynamic theme (optional but recommended) GitHub β†’

πŸ™ Acknowledgements

This project is possible thanks to the work of:



@Nerwyn


Material You Theme


@beecho01


Material Symbol Icons

πŸ’ Support the Project

If this project was helpful to you, consider supporting it!

β˜•

Buy Me a Coffee

Buy me a coffee


Your support helps keep the project alive!
⭐ Leave a star on GitHub if you like it


πŸ› οΈ Contribute

This project is currently in alpha. Your contribution is valuable!

How you can help:
πŸ› Report bugs or issues
πŸ’‘ Suggest new features
πŸ“ Improve documentation
πŸ”§ Submit pull requests

πŸ“œ License

License: Apache 2.0

Free to use, modify, and distribute under Apache 2.0


Made with ❀️ for the Home Assistant community