Bonbon Logo

A sweet and simple Rust library for generating static diabetes data visualizations.

Bonbon is a fast, customizable graph rendering library designed for diabetes related data visualization. It supports glucose entries, insulin doses, carbohydrate intake, and manual blood glucose readings with configurable themes, units, and layout options.

• Flexible Units: Support for mg/dL, mmol/L, or dual-unit display
• Treatment Visualization: Insulin boluses, carbohydrate entries, and manual BG readings
• Customizable Themes: 6 built-in themes. (See Theme::builtins()) with full customization support
• Dynamic Scaling: Automatic Y-axis scaling based on glucose values
• Timezone Support: Accurate time axis labels for any timezone
• Microbolus Filtering: Configurable threshold to simplify SMB visualization
• BG Card: Compact status card showing current glucose, trend, delta, IOB/COB, and a 3 hour sparkline
• Time in Range Card: TIR summary with a stacked band bar, per-band durations and counts, plus average, SD, CV and GMI statistics

The Glucose Graph is a full-resolution chart rendering glucose entries over time, with optional treatment markers (insulin boluses, carbs, manual BG readings), configurable Y-axis scaling, timezone-aware time axis, and dual-unit support.

Example Glucose Graph

The BG Card is a compact ×ばつ320 status card (scalable via with_scale) that renders current glucose, trend arrow, delta, age, IOB/COB, and a color-coded 3-hour sparkline with an ambient gradient fill.

BG Card - In Range BG Card - Low

The Time in Range Card is a ×ばつ400 summary (scalable via with_scale) of how much time was spent in each glycemic band (very low, low, in range, high, very high) rendered as a stacked bar with per-band percentages, durations and reading counts, and a statistics footer (average, SD, CV, GMI, target range). Band thresholds, units, theme and the 3-band/5-band layout are configurable, and the computed numbers are available without rendering through TirStats::compute.

Time in Range Card

Add Bonbon to your Cargo.toml:

[dependencies]
bonbon = "0.4.1"

Some usage examples can be found in the bonbon/examples directory.

Additional documentation can be found on the docs.rs website.

To achieve the best possible rendering speed, it is highly recommended to compile with native CPU optimizations. This enables modern SIMD instructions (AVX2, NEON, etc.), which accelerates the pixel blending and sprite rendering operations.

You can enable this by setting the RUSTFLAGS environment variable:

RUSTFLAGS="-C target-cpu=native" cargo build --release

Or by adding a .cargo/config.toml to your project:

[build]
rustflags = ["-C", "target-cpu=native"]

Averaged across 8 rendering scenarios (InRange, High, Low, multi-status, mmol/L, flat sparkline, single point, no sparkline).

This project is licensed under the MPL-2.0 License. See the LICENSE file for details.

This project uses Material Icons by Google, licensed under the Apache License 2.0. https://github.com/google/material-design-icons