[BUG] Brief UI flash/flicker on initial page load (underlined header border visible before boxed settings load)

[SachaKeserovic]

Description

Upon loading or refreshing the dashboard, there is a subtle but noticeable visual flickering/flashing issue. During the brief fraction of a second while the page renders and loads configuration settings, an unwanted horizontal black bar/line appears across the header area before disappearing or snapping into the correct layout.

This line looks identical to the default border rendered when using headerStyle: underlined, even though my configuration explicitly sets headerStyle: boxed. It seems as if the default header styles/layout are briefly rendered on screen prior to settings.yaml preferences being parsed and applied.

To Reproduce

1. Configure settings.yaml with headerStyle: boxed.
2. Open the Homepage dashboard in a browser (or force refresh with Ctrl + F5).
3. Observe the top header section during the initial render moment.

Expected behavior
The page should load with the configured boxed header style immediately, or without displaying a transient default underline border during the initial render pass (e.g. by hiding or defaulting gracefully before hydration/config load).

The same applies with the background that is grey during this moment instead of the configured background.

Honestly, in the current state I cannot use the app, this flickering/flashing is too annoying.

homepage version

v2.1.0 (93763b7, Aug 21, 2026)

Installation method

Docker

Configuration

---
title: HomeLab
description: HomeLab
headerStyle: boxed
background:
  image: https://wallpapercave.com/wp/wp4565843.jpg
  blur: md
  saturate: 50
  brightness: 50
  opacity: 70
theme: dark
color: slate
useEqualHeights: true
quicklaunch:
  searchDescriptions: true
  hideInternetSearch: true
  showSearchSuggestions: true
  hideVisitURL: true
hideVersion: false

layout:
  Infrastructure:
    header: true
    style: row
    columns: 4

  Applications:
    header: true
    style: row
    columns: 4

  Multimédia:
    header: true
    style: row
    columns: 4

Container Logs

No response

Browser Logs

No response

Screenshots

During load :

After load :