Skip to content

fix(explorer): scroll the Explore panel vertically on overflow - #423

Merged
crs48 merged 2 commits into
mainfrom
claude/explore-section-vertical-scroll-c43bb1
Jul 9, 2026
Merged

fix(explorer): scroll the Explore panel vertically on overflow#423
crs48 merged 2 commits into
mainfrom
claude/explore-section-vertical-scroll-c43bb1

Conversation

@crs48

@crs48 crs48 commented Jul 9, 2026

Copy link
Copy Markdown
Owner

Problem

When the left-nav Explorer panel had a lot of content (many pages, databases, workspaces, folders, tags), it did not scroll vertically — overflowing content was clipped and unreachable.

Root cause: ExplorerSections wrapped everything in overflow-hidden, while the sub-sections each carried percentage height caps as non-shrinking flex children — max-h-[34%] (Spaces) + max-h-[45%] (Folders) + max-h-[30%] (Tags) = 109%, before the unbounded Pinned/Recent block and the flex-1 list. When several sections were full, their combined height exceeded the panel and the excess was clipped with no scrollbar.

Fix

Make the whole panel one vertical scroll region:

  • ExplorerSections becomes a single overflow-y-auto container (relative so it's the offset parent).
  • Spaces / Folders / Tags / Pinned-Recent drop their per-section max-h-[…%] shrink-0 overflow-y-auto caps and grow to natural height, scrolling together with the Unfiled list.
  • The virtualized Unfiled list keeps virtualization but now windows against the shared scroll parent via scrollMargin, re-measured with a ResizeObserver whenever the sections above collapse, expand, mount, or unmount (e.g. when a filter hides them).

Verification

Drove the real app in the browser preview with 20 workspaces, 20 folders, 20 tags, and 40 pages seeded:

  • ✅ Panel scrolls: scrollHeight 2730 vs clientHeight 496 (2234px previously-clipped content now reachable)
  • ✅ All sections reachable end-to-end (Spaces → Folders → Tags → Unfiled)
  • ✅ Virtualized rows pixel-perfect: exactly 26px apart on-screen and in translateY, no gaps/overlaps, list runs to the last item
  • ✅ Dynamic scrollMargin re-measure verified — applying a filter unmounts the sections above and the list re-aligns at its new offset
  • ✅ No console errors; 188 workbench unit tests pass

Files: apps/web only (private app — no changeset needed).

🤖 Generated with Claude Code

@crs48
crs48 temporarily deployed to pr-423 July 9, 2026 02:36 — with GitHub Actions Inactive
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

✓ Changelog fragment found — thanks!

xNet Test and others added 2 commits July 8, 2026 19:39
The Explorer panel clipped its content: `ExplorerSections` used
`overflow-hidden` while Spaces/Folders/Tags each carried percentage
height caps (34%+45%+30% = 109%) as non-shrinking flex children, plus
an unbounded Pinned/Recent block. When several sections were full the
combined height exceeded the panel and the excess was unreachable.

Make the whole panel one vertical scroll region: sub-sections grow to
their natural height and scroll together, and the virtualized Unfiled
list now windows against the shared scroll parent via `scrollMargin`
(re-measured with a ResizeObserver as sections above collapse, expand,
mount, or unmount) so all content stays reachable and rows stay aligned.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: xNet Test <test@xnet.dev>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: xNet Test <test@xnet.dev>
@crs48
crs48 force-pushed the claude/explore-section-vertical-scroll-c43bb1 branch from 0824d96 to 21d0f71 Compare July 9, 2026 02:40
@crs48
crs48 temporarily deployed to pr-423 July 9, 2026 02:43 — with GitHub Actions Inactive
@crs48
crs48 merged commit c3d9c7e into main Jul 9, 2026
14 of 15 checks passed
@crs48
crs48 deleted the claude/explore-section-vertical-scroll-c43bb1 branch July 9, 2026 02:48
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

🖼️ UI changes in this PR

No visual differences detected in the changed UI.

CI run

github-actions Bot added a commit that referenced this pull request Jul 9, 2026
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

Preview removed for PR #423.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant