evidence · 2.6 KiB

wireframes.md

Committed at docs/research/handheld-ux/wireframes.md. This is what grounds the requirements that cite it.

Open raw source

Current and recommended portrait frames

The diagrams are current schematics traced from the cited native captures, not screenshots. The proposed side is a contract for successors, not an implementation preview.

Apps, keyboard hidden

CURRENT (native evidence)                 RECOMMENDED CONTRACT
+--------------------------------+         +--------------------------------+
| Apps | Windows | Keyboard | Sys | 56px   | Apps | Windows | Keyboard | Sys |
+--------------------------------+         +--------------------------------+
|            Applications        |         | title + one state line          |
|       7 installed · Page 1/4   |         | clearly distinct hierarchy      |
|                                |         |                                |
|      [ Terminal            ]   |         | [ primary card, 56px+ target ] |
|      [ Monitor             ]   |         | [ title + short hint ]          |
|      [ New terminal        ]   |         | [ visible focus/status ]        |
|                                |         |                                |
| [ Previous ] [ Back ] [ Next ] |         | [ Previous ] [ Back ] [ Next ] |
+--------------------------------+         +--------------------------------+

Reference: Apps with keyboard (captured 2026-09-23) shows the current title/card/footer hierarchy; the shown keyboard changes the usable height rather than proving every target is physically reachable.

Overview / transient state

+--------------------------------+
| persistent controls remain     |
+--------------------------------+
| Windows · 2 running · Page 1/1 |
| [ terminal title · normal   ]  |
| [ Monitor · focused          ] |
|                                |
| loading / empty / stale / fail |
| must name what happened and    |
| expose Back or Apps/Home       |
+--------------------------------+

The current two-card composition is visible in overview.png. A future live-card surface follows the card proposals; it must not hide the persistent recovery route.

Reviewable SVG sheets