Skip to Content

ink-scroll-list

A high-level list component for Ink applications. Manage selection, auto-scrolling, and content alignment with ease.

Loading demo...

Powered by ink-canvas & ink-scroll-bar

Why ink-scroll-list?

A controlled component for list navigation in your CLI apps.

🎮

Controlled Selection

Selection state is fully managed by the parent via the selectedIndex prop. You have complete control over navigation logic.

👀

Auto-Scrolling

Automatically scrolls the viewport to keep the selected item visible whenever selectedIndex changes.

🎯

Smart Alignment

Control how items align when selected: Top, Bottom, Center, or Auto (minimal scrolling). Configure via scrollAlignment prop.

🔒

Scroll Constraints

When a selection exists, scroll methods are constrained to keep the selected item visible. Supports large items too!