Graphite Theme for Home Assistant

Graphite is a modern theme that offers a soothing dark mode alongside a bright, clean light mode. It uses native device fonts and maintains a unified design language across all Home Assistant interfaces, from the admin panel to code editors. In addition to the standard light and dark modes, Graphite also includes dedicated e-ink variants specifically for e-paper displays. These minimalist themes are optimized for readability, providing a crisp and battery-friendly experience ideal for dashboards on e-ink devices.

Installation

Follow the Quickstart Guide

Or read the setup instructions here

Step 1: Install HACS

If you haven't already, install HACS by following the official guide.

Step 2: Add the Graphite Theme Repository

Open Graphite in your Home Assistant HACS instance

Alternatively

1. Open the HACS interface in Home Assistant.
2. Search for Graphite Theme or use the direct link below:
3. Click Install to add the theme to your setup.

Step 3: Configure your theme directory

Ensure your configuration.yaml is set up to include custom themes:

frontend:
  themes: !include_dir_merge_named themes

Step 4: Restart Home Assistant

Restart your Home Assistant instance to apply changes.

Step 5: Select the Graphite Theme

1. Go to your User Profile in Home Assistant.
2. Under Themes, select Graphite (Light or Dark) from the dropdown menu.

Manual Installation

For manual installation, you can follow these steps:

1. Download and copy the themes folder into your Home Assistant configuration directory.
2. Add the following to your configuration.yaml:

   frontend:
     themes: !include_dir_merge_named themes

3. Restart Home Assistant.
4. Choose the Graphite theme from your profile.

---

Personalize Graphite

Customize the Graphite theme's primary color and more without needing to fork the project by using the Graphite Theme Patcher. This tool is designed for advanced users with technical expertise and experience in script and config modification. For detailed setup instructions, refer to the patcher's documentation.

---

Theme Development Kit

I've created a token abstraction and a script to help maintain Graphite's consistency across theme variants and simplify updates. This setup can also serve as a great starting point for building your own themes in no time. Theme Development Kit

---

E-Ink Themes

Graphite also offers two themes designed specifically for E-Ink displays: Graphite E-Ink Light and Graphite E-Ink Dark. These themes mark the beginning of the Graphite E-Ink family. While they may still need some fine-tuning, your feedback is welcome and will help guide future improvements.

---

Examples

If you're curious about the cards from my screenshot, you can check out my examples.

---

Personal note

Hi there, I'm Tilman, nice to meet you! I'm a product designer and software engineer with a love for blending technology, art, design, and open-source projects. I live in a cozy 16th-century home that I'm gradually turning into a smarter, more connected space.

I started designing this theme in 2022 to make our smart home more intuitive and visually harmonious for my partner Sophia and me. The goal was to create an experience that's both user-friendly and aesthetically pleasing, without needing extra complexity or plugins.

I hope this theme makes your Home Assistant experience even better! If you love it, leaving a star would mean a lot and help others find it too.

---

Inspired by many of the awesome home assistant community themes and contributors.
Thank you for your creativity, dedication and inspiration!