Skip to main content
The Pantry is a two-pane terminal browser. The sidebar on the left shows a navigation tree of your ingredients. The preview area on the right renders the selected widget with its description, props, and source breadcrumb.

​
Tabs

Four tabs organize ingredients by scope. Each tab maintains its own independent navigation state. Cursor position, expansion, and scroll offset are preserved when you switch between them.

​
Widgets

Atomic components in isolation. Each ingredient renders one widget configuration with mock data. Widgets tab

​
Panes

Composed sections combining multiple widgets into cohesive panels: resource gauges, activity feeds, metric panels. Panes tab

​
Views

Full-page layouts assembling panes and widgets into complete screens. Use views to preview how your components compose at terminal scale. Views tab

​
Styles

Color palettes and typography driven from pantry.toml. Named swatches with hex values grouped by family, plus text hierarchy samples. No code required. The Pantry auto-generates these ingredients from your configuration. Styles tab The sidebar displays a collapsible tree. Groups (widget names) expand to reveal variants underneath. Use j/k or arrow keys to navigate, h/l to collapse and expand groups, and Enter to toggle a group or focus the preview for interactive widgets. Scrolling follows the cursor automatically. The viewport adjusts to keep the selected entry visible.

​
Focus modes

The Pantry has three focus modes:
  1. Sidebar (default). Keyboard input controls navigation.
  2. Preview. Press Enter on an interactive ingredient to give it keyboard and mouse focus. The ingredient receives key and mouse events directly. Press Esc to return to the sidebar.
  3. Fullscreen. Press f to expand the selected ingredient to fill the entire terminal. Press f or Esc to return.

​
Color depth cycling

Not all terminals support TrueColor. SSH sessions, tmux without passthrough, older emulators, and accessibility configurations quantize your palette down to 256, 16, 8, or monochrome. Press c to cycle through all five color depths and see exactly how your widget degrades:
  • TrueColor (24-bit): full palette
  • 256-color: xterm extended palette
  • 16-color: ANSI standard
  • 8-color: ANSI basic
  • Mono: no color
The quantization applies to the rendered buffer in real time, showing you what your users actually see in constrained environments.

​
Theme toggle

Press t to toggle between dark mode (Catppuccin Mocha) and light mode (Catppuccin Latte). The default can be set in pantry.toml. See Configuration.