📊 SugarCharts
Terminal charts for SugarCraft
Sparkline, Bar, Line, Heatmap, Scatter, TimeSeries, Streamline, Waveline, OHLC, plus inline image rendering via Sixel / Kitty / iTerm2 protocols. Auto-detects terminal capability.
Install
composer require sugarcraft/sugar-chartsQuickstart
use SugarCraft\Charts\Sparkline\Sparkline;
use SugarCraft\Charts\BarChart\BarChart;
use SugarCraft\Charts\LineChart\LineChart;
echo Sparkline::new([1, 3, 2, 8, 5, 4, 7, 6], 8)->view() . PHP_EOL;
// ▁▃▂█▅▄▇▆
echo BarChart::new(
[['cpu', 0.7], ['mem', 0.4], ['disk', 0.9]], 20, 5
)->view() . PHP_EOL;
echo LineChart::new([1, 4, 2, 8, 6, 3, 7], 30, 6)->view();What's in the box
CanvasFixed cell grid with rune + Sprinkles Style per cell. Foundation under every chart type.
SparklineSingle-row series via 8 Unicode bar glyphs. Perfect for log dashboards.
Bar / LineAuto-scaling y-axis, configurable axis labels, optional grid.
HeatmapDensity visualisation with palette gradients.
OHLCCandlestick chart for financial time-series.
TimeSeriesStreaming series with bucket aggregation.
Picture (Sixel/Kitty/iTerm2)Inline raster image rendering. Auto-detects via terminal-version query.
Source & demos
- Source on GitHub
- Full README
- Runnable examples
- Port of ntcharts (Go upstream)
API
| Class | Method | Description |
|---|---|---|
| Sparkline | new(data, width) | Create sparkline chart |
| Sparkline | view() | Render sparkline |
| BarChart | new(data, width, height) | Create bar chart |
| BarChart | view() | Render bar chart |
| LineChart | new(data, width, height) | Create line chart |
| LineChart | view() | Render line chart |
| Heatmap | new(data, width, height) | Create heatmap |
| Canvas | new(width, height) | Create chart canvas |
