From f3048f480429bf24208085f57643320af999e229 Mon Sep 17 00:00:00 2001 From: ajnart Date: Fri, 14 Aug 2026 10:09:27 +0200 Subject: [PATCH] docs: correct board interaction guidance --- .../docs/advanced/keyboard-shortcuts/index.mdx | 14 ++++++++++++++ .../getting-started/after-the-installation.mdx | 3 ++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/apps/docs/docs/advanced/keyboard-shortcuts/index.mdx b/apps/docs/docs/advanced/keyboard-shortcuts/index.mdx index fa504f82b..3666a5eeb 100644 --- a/apps/docs/docs/advanced/keyboard-shortcuts/index.mdx +++ b/apps/docs/docs/advanced/keyboard-shortcuts/index.mdx @@ -12,6 +12,20 @@ Homarr has the following keyboard shortcuts: | `MOD` + `J` | Toggles Dark Mode | | `MOD` + `E` | Toggles Edit Mode | +## Board editing + +When a tile is focused in edit mode: + +| Shortcut | Description | +| -------------------- | --------------------------------------------------------------------------- | +| `Enter` or `Space` | Starts or stops keyboard editing | +| Arrow keys | Moves the focused tile within its current canvas, rail, or Container | +| `Shift` + Arrow keys | Resizes from the tile's lower-right corner: Left/Up shrink; Right/Down grow | +| `Esc` | Stops keyboard editing without undoing its changes | + +Keyboard moves and resizes apply immediately. To move an item between a canvas, rail, or Container, drag it there or use **Move / resize item** for precise numeric placement. +Commands at a grid boundary or at the tile's minimum size are ignored and announced instead of moving or shrinking the tile. + :::tip Here `MOD` refers to the modifier key, which is `Ctrl` on Windows and `Cmd` on macOS. diff --git a/apps/docs/docs/getting-started/after-the-installation.mdx b/apps/docs/docs/getting-started/after-the-installation.mdx index 97812b423..0ddee5935 100644 --- a/apps/docs/docs/getting-started/after-the-installation.mdx +++ b/apps/docs/docs/getting-started/after-the-installation.mdx @@ -228,7 +228,8 @@ The tile snaps to the grid. Equally-sized tiles swap when one is dropped into th Every `1 × 1` tile has a logical content size of `200 × 200` pixels. Larger tiles use multiples of that fixed unit, with a consistent gap between cells. Homarr scales the complete board uniformly, like zooming a page. -It stops shrinking at 75% and lets you scroll horizontally instead of making text and controls too small. +The complete canvas always fits the available width without horizontal board scrolling. +Below 100%, Homarr preserves the widget's readable typography and control density instead of shrinking each widget independently. It does not squeeze or reflow the content of individual widgets, so a widget keeps the same design and proportions across screen sizes. :::note