Very Dark Black Theme for Home Assistant

A Home Assistant dark mode theme that provides black or very dark backgrounds wherever possible along with a choice of primary colours.

📋 Requirements

• card-mod – The Card Mod integration is required for this theme.

📊 Compatibility

To ensure all "Pure Black" features (like custom scrollbars and border removals) work correctly, verify you meet these minimum requirements:

Dependency	Minimum Version	Reason
Home Assistant	2022.11.0	Required for ha-card border variables.
card-mod	3.0.0	Required for theme-level CSS injection.

✨ Features

This is a simple theme focused on providing a very dark mode look. It's designed to be clean and simple, with a choice of primary colours.

• Black Backgrounds: Black background applied everywhere.
• Primary Colour Choice: Various sub-themes with different foreground colours.
  • Cyan
  • Green
  • Red
  • Fuchsia
  • Orange
  • Purple
  • Indigo
  • Silver (Monochrome)
  • Black Base (Shared Config): A utility theme used for shared logic.

🖼️ Screenshots

🚀 Installation

Prerequisites: Enable themes and install card-mod

1. Install card-mod via HACS or per the instructions on its GitHub page.

2. Add the following to your configuration.yaml file if not present (HA restart required):

frontend:
  themes: !include_dir_merge_named themes

Download Theme

HACS

1. Add this URL as a Custom Repository in HACS.

2. Click Download.

Manual

1. Under the Home Assistant config folder, create a new folder named themes.
2. Copy the theme yaml file into it.
3. Run the frontend.reload_themes action (Restart Home Assistant if configuration.yaml changes were made).

Apply Theme

• Go to your Profile General tab (bottom left of screen) and change Theme under Browser Settings.

Automate Theme Changes

You can use a Home Assistant automation to change the theme at startup, or based on any other time or condition you wish.

Important: In the Profile General screen, you must keep "Use default theme" selected under the Theme settings. If you manually select a specific theme in your profile, the automation will not be able to override it.

Example automation to set the theme at startup:

alias: Set (Default) Theme at Startup
description: >-
  This automation allows you to set or change the default theme at Home Assistant Startup, provided you keep the Default Theme selected.


triggers:
  - trigger: homeassistant
    event: start
conditions: []
actions:
  - action: frontend.set_theme
    metadata: {}
    data:
      name: Black with Orange
      name_dark: Black with Orange
mode: single

🛠️ Development

For technical details on the YAML standards, icon logic, and Shoelace tokens used in this theme, see the Development Reference.

🛠 Maintenance Status

This is a personal project. Support and updates are provided on a "best-effort" basis only. While I use this theme daily and aim to keep it functional with the latest Home Assistant releases, I cannot guarantee immediate fixes for issues or compatibility with all releases.

🙏 Acknowledgements & Thanks

• Inspired by the excellent Frosted Glass themes of @wessamlauf - thank you!
• Made possible by @thomasloven and the card-mod contributors.
• This project was developed with the assistance of Gemini AI to ensure code quality and best practices.