From 096b6720b6967be3b6a3f066ad19145f6697a626 Mon Sep 17 00:00:00 2001
From: Jakub <106778416+MarekZegare4@users.noreply.github.com>
Date: Fri, 29 May 2026 10:45:09 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20rewrite=20favourites=5Fdial.md=20?=
 =?UTF-8?q?=E2=80=94=20layout,=20navigation,=20badges,=20pin/unpin?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 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
---
 .../favourites_dial/favourites_dial.md        | 61 +++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 docs/plus_features/favourites_dial/favourites_dial.md

diff --git a/docs/plus_features/favourites_dial/favourites_dial.md b/docs/plus_features/favourites_dial/favourites_dial.md
new file mode 100644
index 00000000..c0a8dc70
--- /dev/null
+++ b/docs/plus_features/favourites_dial/favourites_dial.md
@@ -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 1–6, 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.