Add link to HA ha-sidebar.ts resource in Documentation

[Mariusthvdb]

what would you think of adding a link to https://github.com/home-assistant/frontend/blob/dev/src/components/ha-sidebar.ts in your documentation of the https://elchininet.github.io/custom-sidebar/home-assistant-built-in-sidebar-configuration-options

I always find it terribly useful to have the HA source code a hand, and also always find it a nuisance to find.....

maybe even list the buit in variables with their respective default values? As an example, this is what I have saved in my theme file, so I always find the correct spot and values directly

# see https://github.com/home-assistant/frontend/blob/dev/src/components/ha-sidebar.ts
#     var(--sidebar-menu-button-text-color, --primary-text-color)
#     var(--sidebar-menu-button-background-color, --primary-background-color)
#     sidebar-background-color: red #ok also above view icons
#     sidebar-icon-color: pink #ok
#     sidebar-text-color: var(--primary-color)
#     sidebar-selected-background-color: orange # ??
    sidebar-icon-color: var(--primary-color)
#     sidebar-selected-icon-color: purple  #ok !! also sets sidebar-selected-background-color
#     sidebar-selected-text-color: yellow #ok
#     sidebar-menu-button-text-color: pink
#     sidebar-menu-button-background-color: black
#     sidebar-selected-icon-color: none
#     sidebar-selected-text-color: green

I believe it would be of additional value to custom-sidebar users to understand the options HA has set, and how to modify/customize those

compared to the additional options of custom-sidebar:

  # --custom-sidebar-background
  # --custom-sidebar-menu-background
  # --custom-sidebar-title-color
  # --custom-sidebar-subtitle-color
  # --custom-sidebar-button-color
#     custom-sidebar-text-color: var(--primary-color)
  # --custom-sidebar-text-color-selected
  # --custom-sidebar-icon-color
  # --custom-sidebar-icon-color-selected
  # --custom-sidebar-selection-background
  # --custom-sidebar-info-color
  # --custom-sidebar-info-color-selected
    custom-sidebar-notification-color: var(--primary-color)
    custom-sidebar-notification-text-color: ivory
  # --custom-sidebar-selection-opacity
  # --custom-sidebar-divider-color

[elchininet]

Hi @Mariusthvdb,
The purpose of that documentation entry is just to clarify what you can achieve natively with Home Assistant without using the plugin, because it could be enough for some users depending on their needs. Custom Sidebar is intended to make personalisations in the sidebar per user or device basis, so if some users just need to change the order and hide items and they don't care about losing the config if they log-out, then that section is for them.

I believe it would be of additional value to custom-sidebar users to understand the options HA has set, and how to modify/customize those

To be honest, the great majority of users will not know what to get from that code, and the majority use Custom Sidebar for things not related to theming (that is the reason that the themable options are now separated from the main options). Also majority of users don't even need to know that Custom Sidebar use variables to set the theming options, most of them just need to know that if you use an option it is applied in certain way. You sometimes forget that you are a user completely out of the ordinary. 😉

[Mariusthvdb]

Ok ok …