SugarDash
Dashboard TUI library — grid layouts, panels, and more
Build dashboard-style terminal UIs with column grid layouts, framed panels, status bars, tabs, and more. Compose complex layouts from reusable components.
Install
composer require sugarcraft/sugar-dashQuickstart
use SugarCraft\Dash\Layout\StackedGrid;
use SugarCraft\Dash\Layout\Frame;
use SugarCraft\Dash\Layout\ItemOptions;
use SugarCraft\Dash\Layout\Options;
$grid = new StackedGrid(new Options(fitScreen: true));
$grid->addItem(new SomePanel(), new ItemOptions(column: 0));
$grid->addItem(new AnotherPanel(), new ItemOptions(column: 1));
$grid->setSize(80, 24);
echo $grid->render();What's in the box
StackedGridColumn grid layout with weighted sizing and gap support.
FrameFramed panel with border, title, and padding.
StatusBarStatus bar component for dashboard footers.
TabsTabbed interface for switching between views.
Card / Box / ParagraphReusable UI components for building panels.
Event systemKeyboard, mouse, focus, and resize event handling.
Showcase examples
Server Showcase
Production dashboard — gauges, charts, avatars, timeline in multi-column layout.
View gif →
View gif →
Source & demos
- Source on GitHub
- Full README
- Runnable examples
- Port of charmbracelet/bubble-grid (Go upstream)
API
| Class | Method | Description |
|---|---|---|
| StackedGrid | new(Options) | Create a stacked grid layout |
| StackedGrid | addItem(item, ItemOptions) | Add item to a column |
| StackedGrid | setSize(width, height) | Set grid dimensions |
| StackedGrid | render() | Render the grid to ANSI string |
| Frame | new(content, title) | Create a framed panel |
| Frame | withBorder(style) | Apply border styling |
| StatusBar | new(items) | Create a status bar |
| Tabs | new(pages) | Create a tabbed interface |
