Skip to content

Commit

Permalink
Merge pull request #133 from NemesisRE/add_main_ui_section
Browse files Browse the repository at this point in the history
Add "how to move header to the bottom" to kiosk-mode complements
  • Loading branch information
NemesisRE authored Nov 6, 2023
2 parents ce43e1f + c25f298 commit 417aa3c
Showing 1 changed file with 24 additions and 1 deletion.
25 changes: 24 additions & 1 deletion KIOSK-MODE-COMPLEMENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,28 @@

Some features are outside `kiosk-mode` scope and they would be hard to maintain and escalate over time, but they could be achieved by alternative methods. This document contains community-driven solutions to achieve things that cannot be done with `kiosk-mode` but could be a complement for Home Assistan instances using this plugin.

### Main UI

`kiosk-mode` is intended to hide elements from the UI to avoid non-authorized users accessing Home Assistant config features specially when it is being shown in a device in kiosk mode. But anything related to change the style of the UI or improve it design falls out of the scope of the plugin. This section contains multiple modifications that could be done in elements of the main UI that are out of the scope of `kiosk-mode`.

#### Move the header to the bottom

This method moves the main Home Assistant header from the top to the bottom of the page. You need to use the [Card Mode Themes] from [card-mod].

```yaml
your-custom-theme:
card-mod-theme: your-custom-theme
card-mod-root: |
.header {
bottom: 0;
top: auto !important;
}
#view {
padding-bottom: calc(var(--header-height) + env(safe-area-inset-top)) !important;
padding-top: 0 !important;
}
```
### Cards
`kiosk-mode` do not modify cards. Mainly because the layout of a lovelace dashboard could have infinite possibilities and it depends on how the user has built it, it is not a fixed layout as the UI of Home Assistant. On top of that, cards change constantly and there are tons of custom-made cards, it will be impossible to maintain and escalate a code that tries to modify whatever card users have in their dashboards. This section contains multiple modifications that you can achieve on cards.
Expand Down Expand Up @@ -51,4 +73,5 @@ card_mod:
}
```

[card-mod]: https://github.com/thomasloven/lovelace-card-mod
[card-mod]: https://github.com/thomasloven/lovelace-card-mod
[Card Mod Themes]: https://github.com/thomasloven/lovelace-card-mod/wiki/Card-mod-Themes

0 comments on commit 417aa3c

Please sign in to comment.