-
Notifications
You must be signed in to change notification settings - Fork 13
tui: keep key bindings discoverable in narrow terminals #79
Copy link
Copy link
Open
Labels
area: tuiTextual terminal user interfaceTextual terminal user interfacebugSomething isn't workingSomething isn't workingdev sprintPythonlings Community Dev Sprint August 2026Pythonlings Community Dev Sprint August 2026good first issueGood for newcomersGood for newcomershelp wantedExtra attention is neededExtra attention is neededsize: SSmall, focused contributionSmall, focused contribution
Description
Metadata
Metadata
Assignees
Labels
area: tuiTextual terminal user interfaceTextual terminal user interfacebugSomething isn't workingSomething isn't workingdev sprintPythonlings Community Dev Sprint August 2026Pythonlings Community Dev Sprint August 2026good first issueGood for newcomersGood for newcomershelp wantedExtra attention is neededExtra attention is neededsize: SSmall, focused contributionSmall, focused contribution
Motivation
Keyboard actions continue to work in a narrow terminal, but the footer hides several essential bindings. A keyboard-only learner cannot discover topic navigation, documentation, or quit keys from the visible interface.
Current evidence
A 40 by 15 Textual pilot on
devate1d4dae37234b75124bd6a53f06734296ebbbdeecompleted the full keyboard flow, but the track footer visibly stopped after F3:F4, F5, and Escape still executed correctly, so this is a responsive discoverability defect rather than broken key handling.
Exact scope
Provide a compact or otherwise accessible binding presentation when the footer cannot fit the normal labels. Keep the existing keys and actions unchanged.
Acceptance checklist
Explicit exclusions
Do not change key assignments, remove footer help at normal widths, redesign the main three-pane layout, or add mouse-only controls.
Likely files
pythonlings/screens/track.pypythonlings/screens/topic_picker.pypythonlings/screens/docs.pypythonlings/pythonlings.tcsstests/tui/test_app_pilot.pyVerification
Exercise the complete keyboard flow at 40 by 15 and at a normal terminal size.
Sprint coordination
See Discussion #37 and tracker #52. This issue is intentionally unassigned. A coordination comment is welcome, but it does not reserve the issue. The first pull request that satisfies every acceptance criterion and verification requirement is considered for merge.