dashboard-builder

Terminal dashboard toolkit — create dashboards with bar charts, gauges, tables, and text panels, all rendered as ASCII art in your terminal.

Commands

create

Create a new dashboard configuration.

scripts/script.sh create server-metrics

add-widget

Add a widget to a dashboard. Types: bar, gauge, table, text.

scripts/script.sh add-widget server-metrics bar "Revenue:85,Costs:42,Profit:43"
scripts/script.sh add-widget server-metrics gauge "CPU:72:100"
scripts/script.sh add-widget server-metrics table "Service:Status|API:OK|DB:OK"
scripts/script.sh add-widget server-metrics text "All systems operational"

render

Render a dashboard in the terminal with ASCII art charts.

scripts/script.sh render server-metrics

Output includes bordered frames, bar charts with █░ characters, gauges with percentage and threshold labels, and formatted tables.

list

List all dashboards with widget counts and sizes.

scripts/script.sh list

show

Show the raw JSON configuration of a dashboard.

scripts/script.sh show server-metrics

delete

Delete a dashboard.

scripts/script.sh delete old-dashboard

export

Export a dashboard to JSON, plain text, or HTML.

scripts/script.sh export server-metrics json
scripts/script.sh export server-metrics html
scripts/script.sh export server-metrics txt

import

Import a dashboard from a JSON file.

scripts/script.sh import backup.json

demo

Show a built-in demo dashboard with all widget types rendered.

scripts/script.sh demo

Examples

# Full workflow
scripts/script.sh create sales-q4
scripts/script.sh add-widget sales-q4 bar "Jan:120,Feb:95,Mar:140,Apr:180"
scripts/script.sh add-widget sales-q4 gauge "Target:340:500"
scripts/script.sh add-widget sales-q4 table "Region:Revenue:Growth|US:2.4M:12%|EU:1.8M:8%|APAC:900K:22%"
scripts/script.sh add-widget sales-q4 text "Q4 revenue on track"
scripts/script.sh render sales-q4
scripts/script.sh export sales-q4 html

Configuration

Variable	Required	Description
DASHBOARD_BUILDER_DIR	No	Data directory (default: ~/.dashboard-builder/)

Data Storage

All dashboards saved in ~/.dashboard-builder/dashboards/ as JSON files.

Each dashboard file contains: - name — Dashboard identifier - created — Creation timestamp - widgets — Array of widget objects with type, data, and ID

Widget data format: - bar: "Label1:Value1,Label2:Value2,..." — comma-separated label:value pairs - gauge: "Label:Current:Max" — single gauge with threshold detection - table: "H1:H2|R1C1:R1C2|R2C1:R2C2" — pipe-separated rows, colon-separated columns - text: "Any message text" — displayed in a bordered panel

Requirements

• bash 4.0+
• Standard Unix tools (grep, sed, wc)

---

Powered by BytesAgain | bytesagain.com | [email protected]