evidence · 3.5 KiB

README.md

Committed at docs/design/handheld-prototype/README.md. This is what grounds the requirements that cite it.

Open raw source

Handheld interaction study

The browser prototype is at /tdisplay-k230/design/handheld/. Its reference screen is 568 × 1232. It studies the proposed gesture model and visual continuity; it is not installed shell UI or board evidence. App output, CPU readings, time, notifications, and network state inside the frame are sample content.

Home is a live-card overview. A bottom-edge upward drag shrinks an app toward its card. Horizontal drags move through cards; tapping one expands it. Dragging a card upward closes it, while the Monitor example refuses and settles back. Another upward drag from the lower part of Home reveals installed apps. A top-edge downward drag reveals notifications and a Settings mockup. Settings can return to notifications or Home. The six controls beside the frame replay these motions for review; pointer gestures work with mouse or touch. There is no permanent in-frame navigation bar.

The installed-app identities shown here match the offline image catalog: Foot (Terminal), htop (Monitor), mpv (Video), nano (Editor), nnn (Files), and the built-in Help. Their presence does not imply that this proposed layout is installed. The page repeats an app icon in the drawer, card header, expanded app, and app-specific notification where that identity is known. Editor, Files, Help, and Settings use original line icons made for this study.

Icon provenance

The three upstream icons were copied unchanged from the same Nix store packages available to the shell. Original paths and SHA-256 values:

AssetOriginal pathSHA-256Attribution / license record
foot.svg/nix/store/spn1xzg7rfnffadkf4r3giv8vawgx2y3-foot-riscv64-unknown-linux-gnu-1.28.0/share/icons/hicolor/scalable/apps/foot.svgafd748355f6feffb2203982abc963d9c503121b8fb394c23dbbcc9ba546e6e04SVG metadata credits Lennard Hofmann, sources FreeSVG human footprints, and declares CC BY-SA 4.0.
htop.svg/nix/store/nyy80gvhfcalcm8g9x3fcx3bgilllj3g-htop-riscv64-unknown-linux-gnu-3.5.3/share/icons/hicolor/scalable/apps/htop.svg91bd25b2d2717993f6989e49bbedcadd0c9583f9b5b58a28f6d2d5e5c5e28703Bundled htop project icon; Nixpkgs package metadata declares GPL-2.0-only. The SVG does not contain an icon-specific license notice.
mpv.svg/nix/store/4sx1s01fbcsjdsqs7c7smyi4ldhxqxm9-mpv-riscv64-unknown-linux-gnu-0.41.0/share/icons/hicolor/scalable/apps/mpv.svgbf6082c81dcc8b8c6351326b53530f461258af9ca71c4642372654eba29c598fBundled mpv project icon; upstream copyright record covers the project under GPLv2+ / LGPLv2.1+ terms depending on build. The SVG metadata does not declare a separate icon license.

The other four SVGs are original work for this study. No third-party fonts or image-generation output were added. The page uses the site’s existing fonts.

Verification

From the repository root:

python3 scripts/build_site.py
python3 site/tests/handheld_design_browser.py

The second command uses Python Playwright and /usr/bin/chromium to exercise the built route. It checks icon loading, live pointer movement and release, pointer cancellation, app return, drawer, shade, Settings, throw/refusal, close/reopen, repeatability, and mobile overflow. The first command checks the site’s 8 MiB output and 120-second build budgets. No board was used.