ink-virtual-listVirtualized lists for terminal UIs

Scroll through 100,000 rows in an Ink app — only what's visible ever renders.

⚡
Virtualized rendering
Render lists of any size — only the visible window hits the terminal, so 12 rows cost the same as 12,000.
🎯
Selection-aware scrolling
The viewport follows selectedIndex as users navigate, with imperative jumps (top / center / bottom) via ref.
📐
Stable height budget
Total rendered height never changes while scrolling — overflow indicators reserve their lines, so surrounding UI stays put.
🖥️
Terminal-aware auto-fill
height="auto" fills the available terminal and re-renders on resize, minus the lines you reserve for your own chrome.
🧩
Composable extras
Custom overflow indicators, thresholds, and a renderScrollBar hook for gauges and scrollbars built on viewport state.
🔷
TypeScript-first
Fully generic API with strict types, tested against Ink 6 and Ink 7 in CI on every push.

logship, a log explorer built with ink-virtual-list: scrolling 12,847 lines with a position gauge and overflow indicators

logship — one of five runnable apps in the Examples gallery, each recorded straight from the repo.

Virtualized rendering