docs: rewrite favourites_dial.md — layout, navigation, badges, pin/unpin

- Describe 2×3 portrait vs 3×2 landscape grid layout
- Navigation: edge keys fall through to page nav
- Unread badge detail (ellipsis + badge coexistence)
- (gone) label for removed contacts
- Two pinning paths: empty tile picker and DM context menu
- Pin picker order: favourited contacts first, then recent DMs
- Auto-move when contact already pinned elsewhere
- Unpin via DM context menu
- Reordering via Settings › Home Pages
This commit is contained in:
Jakub
2026-05-29 10:45:09 +02:00
parent 57ac1b42b2
commit 096b6720b6

View File

@@ -0,0 +1,61 @@
## Favourites Dial
[Go back](../../../README.md)
### Overview
| OLED | E-Ink |
|:----:|:-----:|
| ![](./fav_dial_1_oled.png) | ![](./fav_dial_1_eink.png) |
A dedicated home page showing a grid of up to 6 pinned contacts for quick access. The layout adapts to the display orientation:
- **Portrait** (OLED, e-ink portrait) — 2 columns × 3 rows
- **Landscape** (e-ink landscape) — 3 columns × 2 rows
---
### Navigation
Navigate tiles with **UP / DOWN / LEFT / RIGHT**. Pressing a directional key at the edge of the grid switches to the adjacent home page instead of wrapping.
**Enter on a filled tile** — opens that contact's DM directly.
**Enter on an empty tile (`+`)** — opens a contact picker to fill the slot.
---
### Unread badge
| OLED | E-Ink |
|:----:|:-----:|
| ![](./fav_dial_2_oled.png) | ![](./fav_dial_2_eink.png) |
Filled tiles show an unread message count in the top-right corner when there are unread DMs from that contact. The contact name is ellipsized to make room for the badge.
If a pinned contact has been removed from the contacts list, the tile shows `(gone)` until the slot is reassigned.
---
### Pinning a contact
**From the Favourites Dial** — press **Enter** on an empty tile (`+`). A picker opens showing:
1. Contacts marked as favourites in the upstream app (starred contacts) — listed first
2. Recent DM contacts — listed after
Select a contact to pin it to that slot.
**From a DM conversation****Hold Enter** context menu **Pin to dial**, then choose a slot from the slot picker (Slot 16, showing the current occupant name or "empty").
If the selected contact is already pinned in another slot, it is moved to the new slot automatically.
---
### Unpinning a contact
Open the contact's DM, **Hold Enter** context menu **Unpin (slot N)**.
---
### Reordering the Favourites page
The position of the Favourites Dial in the home page navigation sequence can be changed in **Settings Home Pages** — press **LEFT / RIGHT** on the Favourites entry to move it earlier or later.