bug(debug-ui): panels are off-screen and the mobile toggle can become unreachable on small displays #1082

Closed
opened 2026-11-07 04:14:15 +00:00 by SakulFlee · 0 comments
Owner

Observed

On the phone, the four debug panels use fixed initial positions and sizes:

Panel Position Size
Performance (40, 40) 440 x 340
ECS (40, 420) 600 x 460
Console (500, 40) 760 x 260
Rendering (960, 320) 300 x 360

That requires roughly a 1260 x 880 logical-pixel viewport. On the phone:

  • Performance is visible in the top left.
  • Console is partly visible at the top right.
  • ECS is only partly visible and can be moved slightly.
  • Rendering is completely off-screen.

The tablet cannot run iced at all because it lacks SHADER_F16 (#1074), so it cannot be used to test the layout.

Mobile toggle trap

mobile_debug_toggle_visible only shows the on-screen "Debug" button when:

overlay is hidden
OR every panel is hidden

ShowDebugUi then sets every panel visible again. If one panel is off-screen but still marked visible, the button stays hidden. The off-screen panel's close button is also off-screen, so the user cannot close it to make the button return. On a phone with no keyboard, this can make the debug UI unreachable.

Proposed direction

  • Use a responsive mobile layout instead of fixed floating windows. The cleanest option is one full-screen panel at a time with a tab strip for Performance, ECS, Console, and Rendering.
  • Keep the current text size; do not shrink the windows until the content is unreadable.
  • Always provide a recovery path on mobile: a persistent small "Debug" button while the overlay is visible, or an explicit "Hide all" / "Reset layout" action.
  • ShowDebugUi should clamp or reset panel positions to the current viewport, including after resize or orientation changes.
  • Keep a visible close/title bar in windowed mode, or provide equivalent navigation in tabbed mode.

Acceptance criteria

  • All four panels are reachable on a phone in portrait and landscape.
  • The debug toggle cannot become unreachable because of an off-screen visible panel.
  • Layout is reset or clamped when the viewport changes.
  • Text remains readable; no tiny fixed windows.
  • Works on a small desktop window as well, not only on mobile.
## Observed On the phone, the four debug panels use fixed initial positions and sizes: | Panel | Position | Size | |---|---|---:| | Performance | (40, 40) | 440 x 340 | | ECS | (40, 420) | 600 x 460 | | Console | (500, 40) | 760 x 260 | | Rendering | (960, 320) | 300 x 360 | That requires roughly a 1260 x 880 logical-pixel viewport. On the phone: - Performance is visible in the top left. - Console is partly visible at the top right. - ECS is only partly visible and can be moved slightly. - Rendering is completely off-screen. The tablet cannot run iced at all because it lacks `SHADER_F16` (#1074), so it cannot be used to test the layout. ## Mobile toggle trap `mobile_debug_toggle_visible` only shows the on-screen "Debug" button when: ```text overlay is hidden OR every panel is hidden ``` `ShowDebugUi` then sets every panel visible again. If one panel is off-screen but still marked visible, the button stays hidden. The off-screen panel's close button is also off-screen, so the user cannot close it to make the button return. On a phone with no keyboard, this can make the debug UI unreachable. ## Proposed direction - Use a responsive mobile layout instead of fixed floating windows. The cleanest option is one full-screen panel at a time with a tab strip for Performance, ECS, Console, and Rendering. - Keep the current text size; do not shrink the windows until the content is unreadable. - Always provide a recovery path on mobile: a persistent small "Debug" button while the overlay is visible, or an explicit "Hide all" / "Reset layout" action. - `ShowDebugUi` should clamp or reset panel positions to the current viewport, including after resize or orientation changes. - Keep a visible close/title bar in windowed mode, or provide equivalent navigation in tabbed mode. ## Acceptance criteria - All four panels are reachable on a phone in portrait and landscape. - The debug toggle cannot become unreachable because of an off-screen visible panel. - Layout is reset or clamped when the viewport changes. - Text remains readable; no tiny fixed windows. - Works on a small desktop window as well, not only on mobile.
Sign in to join this conversation.
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
SakulFlee/Orbital#1082
No description provided.