How-to guides

Long-form walkthroughs grounded in real problem-solving with pond-ts. Each guide is built around a working reference implementation — agents and contributors who hit friction in specific shapes have written up their experiences for future readers.

Available:

• Building a dashboard — adapted from the dashboard agent's reference repo. React + LiveSeries ingest, throttled snapshot reading, per-host rolling baselines, anomaly detection, and chart-library bridging — built around a ~600-line working dashboard.
• Ingesting messy data — adapted from a CSV-cleaner agent run on a real-world per-host metrics dump (mixed timestamp formats, four spellings of "missing," duplicate-retry rows, multi-host interleaving, gap-from-missed- scrapes). Walks through schema declaration, boundary normalization, dedupe, partitionBy for per-entity scope, gap- capped fill, and optional regularization with materialize.
• Histograms — stacked bars, value / ordinal band axes, and horizontal orientation with @pond-ts/charts, where the buckets come from pond's own aggregation (aggregate / byColumn / partitionBy). Four worked examples: incidents-by-host, risk bands, heart-rate zones, and a power distribution.
• Categorical charts (the transpose view) — categories on the x-axis (ticker / account / zone) as the transpose of the time chart: read one row of a wide series across into a bar per column, via pivotByGroup → transposeRow → <BarChart categories>. Covers the band scale, stable per-column selection, and the high-cardinality label policy.

In flight:

• A gRPC stream-processor guide once that experimental work surfaces something worth writing up.

For shorter, primitive-focused docs, see the pond-ts core reference and @pond-ts/react reference.