UI is a free, open source internet of things (iot) project written in JavaScript and released under MIT. It has 2,081 GitHub stars, 422 forks and 38 open issues, and was last pushed 3 days ago. On this registry it ranks #39 of 99 tracked projects in Internet of Things (IoT), with 5 head-to-head comparisons available. It gained 11 stars over the last 22 tracked days.

What is UI?

UI-Lovelace-Minimalist is a theme-like dashboard package for Home Assistant users who want a pre-built, minimalist Lovelace interface without designing cards themselves.

What it is

UI-Lovelace-Minimalist is a collection of dashboard components for Home Assistant, distributed through HACS and described by its own authors as a "theme" in quotation marks — it is less a colour scheme than a complete set of ready-made Lovelace cards, chips, popups and templates that you apply to your Home Assistant dashboard. The project packages the original SmartHomeUI design work by tben into something that can be installed and updated as a normal repository, and it relies on the custom-cards button-card for much of its technical behaviour.

The concrete problem it solves is the effort of hand-writing Lovelace card YAML for every entity on a smart-home dashboard. Instead of building each card individually, a user picks from a bundled library: the current version ships 20 different cards, seven chips, and further templates, plus a growing set of custom_cards that are documented separately with screenshots and code examples. The documentation itself lives in an extensive Wiki rather than the README, covering Download, Installation, Configuration, Cards, Chips, Popups, Custom-Cards and a Card Style Guide.

Key capabilities

  • Ships 20 different card templates and seven chips bundled into a single download, alongside other templates.
  • Provides a documented custom_cards library, including custom_card_bar_card, with pictures, code examples and additional information.
  • Includes popups and card styling conventions covered by a dedicated Card Style Guide and Docs Style Guide in the Wiki.
  • Is installable and updatable as a repository through HACS, with separate guides for download, installation, configuration and upgrading from a previous version.
  • Builds on the button-card from the custom-cards organisation, so card behaviour is driven by that project's templating.
  • Covers the full workflow in its Wiki: Setup, Usage and Development sections, with a developer corner for contributors.
  • Ships under the MIT licence and is written primarily in JavaScript.

Who uses it and how

  • Home Assistant users who run a Lovelace dashboard and want a complete minimalist look without writing card YAML for each entity.
  • HACS users who install and update the package through the Home Assistant Community Store rather than manual file copying.
  • Dashboard builders who mix bundled cards with the documented custom_cards library to extend the interface as their entity count grows.
  • Contributors who work in the project's developer corner, following the Card Style Guide and Docs Style Guide when adding templates, and who coordinate through the project's Discord server or GitHub Discussions.

Getting started

Install the repository through HACS in Home Assistant and then follow the Wiki's Download, Installation and Configuration guides to add the bundled cards and templates to your dashboard.

How it compares

The project positions itself against hand-built Lovelace dashboards and against the raw button-card templates it derives from: rather than writing and maintaining button-card YAML yourself, you consume a curated, documented set of cards, chips and popups that the maintainers refactor and keep consistent. Its scope is narrower than a general dashboard framework — it contributes templates styled on tben's SmartHomeUI design rather than a new rendering engine.

When to use it — and when not

You must be running Home Assistant and comfortable installing a HACS repository, configuring Lovelace, and reading an external Wiki rather than a self-contained README, since the README defers almost all detail to the documentation site. Potential adopters should note the project's own notice that it is looking for new maintainers — the current maintainers are no longer actively working on it and have warned that the project and its Discord server may be shut down without fresh leadership — so the 38 open issues and long-term upkeep are real considerations; anyone unwilling to operate community support themselves, or who needs a guaranteed support path, should weigh that risk before committing a dashboard to it.

project readme (upstream, from github) — read inline

UI-Lovelace-Minimalist

Discord Version hacs installs Downloads Visualise Repo

[!IMPORTANT] Looking for New Maintainers!

This project is in need of new maintainers! The current maintainers are no longer actively working on it, and without fresh leadership, we may be forced to shut down the project and its associated Discord server.

If you're passionate about this project and would like to take over its development and community management, we’d love to hear from you!

Thank you for considering helping keep this project alive and thriving! 🙌

It's kind of hard to explain what this is, so let's call it a "theme" (in quotation marks). But one thing is for sure, it is very nice! Taking the exceptional work of tben as a basis, this repository is aimed to ease installation and maintenance of his wonderful work. You can use this interpretation of a SmartHomeUI more or less like a theme in HomeAssistant.

example-image1 example-image2 example-image3 example-image4

Wiki for documentation

We have setup an extensive Wiki for our documentation. It is more comfortable for you to read and for us to handle, than this file and gives our documentation the right framework to grow. Take a look here: https://ui-lovelace-minimalist.github.io/UI/

Table of content from the WIKI

Setup Usage Development

We have provided different guides to help you install and update this "theme"

These usage guides give you a deeper knowledge about this "theme"

This is our developer corner

» Download
» Installation
» Configuration

» Cards
» Chips
» Popups
» Custom-Cards

» Card Style Guide
» Docs Style Guide
» Custom-Cards

Installation and update

We can offer you in-depth instructions for installation, as well as for future updates or from a previous version. Check our WIKI for more info:

List of templates

The actual version of this "theme" has 20 different cards, seven chips and other templates bundled into the download. We're sorry, but the list wouldn't fit into this readme. Please see this page, where you can find an extensive list of templates with code examples, screenshots and explanation.

Custom cards

The same goes for our custom_cards. As the number grows, the list would be to big for this readme, so we provide you with an overview page with pictures, code examples and additional information. Find the list here.

Credits & Contributors

  • This design was made by tben
  • A lot of inspiration is taken from 7ahang’s work found on Behance.
  • Contributions from others in the HomeAssistant forum thread, you can find it here.
  • The technical part is realised mostly by taking advantage of the great work RomRaider did with his button-card.
  • Code refactor, cleanup and maintenance by schumijo and paddy0174 & CM000n.
  • dwainscheeren for his inspiration to deliver themes via HACS.
  • Wiki by paddy0174.
  • Special thanks to clemalex and schumijofor contributing their cards to the main repository.
  • stokkie90 for implementing most of the HACS functionalities.
  • wilbiev for maintaining the code and all improvements.
  • And of course all the others who cannot be named here due to space limitations.

❤️ Thank you so much for helping to keep this UI awesome

Contributions

This is a living project and all input is very welcome! If you configured and designed a card, that you would like to share, please feel free to do so! We are happy to include your contribution so others can use it as well! This project uses pre-commit for consistent and clean code. If possible, please make sure that you also use pre-commit for local development before creating a pull request.

Frequently asked questions

Is UI free to use?

UI is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does UI do?

UI-Lovelace-Minimalist is a "theme" for HomeAssistant

What is UI written in?

UI is primarily written in JavaScript. Its source is publicly available at https://github.com/UI-Lovelace-Minimalist/UI, and it has 2,081 GitHub stars.