Skip to content

Commit c55d452

Browse files
docs: record the bounded-shell lesson in LESSONS.md
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent 453c53a commit c55d452

1 file changed

Lines changed: 8 additions & 0 deletions

File tree

LESSONS.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -169,6 +169,14 @@ number was a **harness artifact, not library behavior** — when a number
169169
in git history at `be701dd:docs/docs/components/field/`) are ~4,900 lines
170170
coupled to the Blackline app (API services, stores, auth, axios boot) —
171171
porting them is a stub-the-backend project, not a file conversion.
172+
- **The app shell must have a HARD viewport height — the virtual scroller
173+
requires a bounded container.** Switching `.shell` to `min-height` (for a
174+
sticky sidebar) made the stage's height content-driven, and the scroller
175+
sizes its render window from its container: bigger container → more rows
176+
rendered → bigger container. Measured runaway: 2,565 → 5,265 DOM items in
177+
12s of autoplay. Tall examples scroll inside `.stage-body`
178+
(`overflow-y: auto`), never by growing the page; Lenis wraps its own
179+
element, so nothing in the playground needs body scroll.
172180

173181
## Process
174182

0 commit comments

Comments
 (0)