Showcase submission: dockstat

[svuritigit]

Project name

dockstat

Repository URL

https://github.com/svuritigit/dockstat

Submission type

App

What should the showcase viewer notice immediately?

A grid of running Docker containers, each with a live CPU sparkline, a colored memory gauge, and network throughput, updating once a second. The immediate visual hook is the contrast between calm green idle containers and a container spiking red under load — it reads as a real-time systems dashboard, not a static list.

What is interesting or novel about this project?

It's read-only by design: it never starts, stops, restarts, or deletes containers, so it's safe to point at any host, including production, purely for observation. CPU percentage and network throughput are computed from successive raw stats samples the same way the Docker CLI does (cumulative counters differenced over time), rather than trusting any single snapshot. The whole UI is built from Ratatui's Sparkline and Gauge widgets driven by an async tokio::select! loop that ticks once a second while still handling keyboard input immediately, backed by bollard for the Docker Engine API.

Screenshot or GIF

https://raw.githubusercontent.com/svuritigit/dockstat/master/docs/demo.gif

Submission checklist

• I read the showcase guidance document linked above.
• The text is readable when the media is scaled down.
• The image or GIF focuses on the UI instead of shell commands or setup noise.
• The media uses strong enough contrast and hierarchy to work on the website.
• If this is a GIF, it stays on each important state long enough to read.
• I checked how the media looks on a narrow or mobile-sized viewport.

Anything else reviewers should know?

The GIF is cropped to 3 containers (idle, CPU-spiking, idle) plus the header, rather than the full container list, so it stays legible at small sizes — at genuinely phone-narrow widths the fine text (percentages, byte counts) does get small, as is typical for text-dense terminal UIs, but the color/shape hierarchy (green vs. red panel) still reads clearly. MIT licensed, cargo install --path . to build. Not yet listed on Awesome Ratatui; happy to add it there as well.

[joshka]

Thanks for the submission. I think this is a good utility, but probably not at the showcase level.
Mainly it feels a bit on the too simple side to reasonably show off Ratatui.
Please submit to https://github.com/ratatui/awesome-ratatui/ though!