A modern, easy-to-use and performant custom Home Assistant dashboard

https://www.youtube.com/watch?v=D8mWruSuPOM

This is a fork of the original ha-fusion project created by matt8707. All credit for the initial development and core architecture goes to the original author.

If you find this project useful, please consider supporting the original creator: ❤️ https://www.paypal.com/paypalme/matt8707

This project is a fork of the repository originally developed by matt8707 and released under the MIT License.

• Original base release: 2024.10.1
• Fork created: 24 September 2025
• Additional development and modifications by: Lorenzo Lingua

This fork includes additional features not present in the original:

• 🎯 Universal Bar Component: The Bar component, originally available only in the sidebar, is now also available in the main dashboard
• 📐 Multiple Sizes: Choose between Compact, Medium, and Large sizes for your bars
• 🖱️ Click to Edit: Direct editing of bar components from the main dashboard
• ⚙️ Enhanced Configuration: Improved modal with size selection and better user experience

This is a fork of the original ha-fusion project created by matt8707. All credit for the initial development and core architecture goes to the original author.

If you find this project useful, please consider supporting the original creator: ❤️ https://www.paypal.com/paypalme/matt8707

For "Operating System" or "Supervised" installation methods, you can install ha-fusion as an add-on. Choose between two versions:

Versione stabile basata sul branch main con Universal Bar Component testato.

1. Add Repository:

2. Install Add-on: Locate "HA Fusion Custom" and install.

🎯 Stai visualizzando il branch DEVELOP! Questa versione include le ultime funzionalità.

Versione development basata sul branch develop con le ultime funzionalità e features sperimentali.

1. Add Repository:

2. Install Add-on: Locate "HA Fusion Custom Dev" and install.

⚠️ Development Version: Include features sperimentali. Sconsigliato per produzione.

🚀 Latest Features in Dev: Universal Bar Component, Dependabot auto-updates, Security fixes, Latest dependencies

For the original version without custom features, use: https://github.com/matt8707/addon-ha-fusion

If you're using the "Container" or "Core" installation methods, ha-fusion can be installed via Docker:

1. Docker Compose File: Place your edited copy of the docker-compose.yml file in a suitable directory. (This version uses develop branch for latest features)

2. Create Container: Run the following commands in your terminal to start the container:

   cd path/to/docker-compose.yml
   docker-compose up -d ha-fusion

To update to the latest version of ha-fusion, run the following commands:

docker-compose pull ha-fusion
docker-compose up -d ha-fusion

docker run -d \
  --name ha-fusion \
  --network bridge \
  -p 5050:5050 \
  -v /path/to/ha-fusion:/app/data \
  -e TZ=Europe/Stockholm \
  -e HASS_URL=http://192.168.1.241:8123 \
  --restart always \
  ghcr.io/matt8707/ha-fusion

...

These will only function if you have exposed a port in the add-on configuration or by using Docker. Note that when using Ingress, query strings cannot be read.

To set a particular view when the page loads, add the "view" parameter. For example, if you have a "Bedroom" view, append the query string ?view=Bedroom to the URL.

To disable the menu button, append the query string ?menu=false to the URL. This is useful when you want to avoid unwanted changes to your dashboard, such as on wall-mounted tablets.

To debug any errors, check the "Log" tab if you're using the addon, or use docker logs ha-fusion for Docker setups. To inspect frontend issues, open the browser's console.

To begin contributing to the project, you'll first need to install node. It's also recommended to install pnpm. If you're unfamiliar with Svelte, consider doing the tutorial at https://learn.svelte.dev

# prerequisites (macos)
brew install node pnpm

# install development version (develop branch) - YOU ARE HERE!
git clone -b develop https://github.com/llingua/ha-fusion-custom.git
cd ha-fusion-custom

# OR install stable version (main branch)
git clone https://github.com/llingua/ha-fusion-custom.git
cd ha-fusion-custom

# or original version
# git clone https://github.com/matt8707/ha-fusion.git
# cd ha-fusion
pnpm install

# environment
cp .env.example .env
code .env

# server
npm run dev -- --open

# dependencies
pnpm outdated
pnpm update

# lint
npm run check
npm run lint
npm run format