the help overlay hides the whole screen

[sam0uly]

Version / branch / commit

0.1.0

OS and environment

NixOS 26.05, kitty and ghostty, go 1.26

Steps to reproduce

1. run zero
2. just click ?
3. the help overlay will replace the entire tui view.

Expected behavior

expected behavior is to be like the other popups like the model picker and suggestions picker etc.
examples:

Actual behavior

The issue is that the help overlay renders in the same layer instead of using lipgloss vs newCanvas and newLayer

which make it looks like that and hides the whole view

its not following the other popups like suggestion picker and provider wizard and model picker

Relevant logs, screenshots, or error messages

No response

[gnanam1990]

Thanks for the clear report and the screenshots — spot on. View() was short-circuiting the whole render to the shortcut block on a blank canvas, so the transcript/title bar/composer all disappeared, unlike the model picker and other popups.

Fix is up in #420: ? now composites over the chat through the same overlay path the pickers use, so the shortcuts box floats on top with everything visible behind it and Esc/? still dismiss it. Verified on an empty home screen and with a populated transcript.

[sam0uly]

Thanks for the clear report and the screenshots — spot on. View() was short-circuiting the whole render to the shortcut block on a blank canvas, so the transcript/title bar/composer all disappeared, unlike the model picker and other popups.

Fix is up in #420: ? now composites over the chat through the same overlay path the pickers use, so the shortcuts box floats on top with everything visible behind it and Esc/? still dismiss it. Verified on an empty home screen and with a populated transcript.

i fixed it already but my network wasnt that good so i opened PR after you without checking the issue ^^

[gnanam1990]

Thanks for a genuinely high-quality report, @N1xev — the repro was exact, the before/after screenshots made it obvious at a glance, and your root-cause call was spot on: the overlay was rendering into the same layer instead of compositing the way the model picker and the other popups do.

Even better that you turned around a fix yourself in #421, and that's the one we're taking forward. It routes the ? overlay through the same viewportOverlay path the pickers and wizards use, and suppresses the sidebar so it renders full-width — exactly the "like the other popups" behavior you asked for here. I've closed my own attempt (#420) in favor of yours and left a couple of regression tests as a suggestion on the PR so the fix stays guarded against future refactors.

Really appreciate you taking it all the way from diagnosis to fix. 🙏