simple-ascii-chart generates customizable ASCII charts for terminals and text-first environments, with support for multiple series, custom symbols, formatters, colors, legends, thresholds, and several chart modes.
Simple-ascii-chart
TypeScriptTerminalASCII charts
Overview
The project turns numeric data into readable terminal output without depending on a browser canvas, SVG, or image export. It is useful when a CLI, CI log, README example, or debugging tool needs to show trend and shape in plain text.
Implementation notes
Input data is normalized into typed coordinate series, then mapped onto a fixed text grid before drawing axes, ticks, labels, thresholds, points, bars, or line segments.
Settings merge defaults with per-chart overrides for dimensions, symbols, formatters, colors, legends, ranges, and chart mode.
The package ships ESM and CommonJS builds with generated TypeScript declarations, Jest coverage, and export checks.
Key points
Works in Node.js, browsers, and terminal output without runtime dependencies.
Supports line, point, bar, and horizontal bar charts with multiple series.
Useful for CLIs, debugging output, CI logs, and documentation examples.
Open the repository to review API examples, chart options, packaging setup, and the tests that keep the terminal renderer predictable.
Related
Designing simple-ascii-chart
Read the article about API design lessons from terminal charts.