Skip to content

Document Information Display color thresholds #50

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
marionbarker merged 1 commit into from
Jul 21, 2026
Merged

Document Information Display color thresholds #50

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 25 additions & 0 deletions docs/setup/lf-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -242,6 +242,7 @@ These items can be chosen for display on the Home screen. A Nightscout Site is r

* The order in the table below is the order in the LoopFollow code
* You can drag the rows up and down to suit your preferred order
* Tap a row to open its detail, where you set its visibility and, for supported rows, [color thresholds](#color-thresholds)

| Name | Description | `Loop` / `Trio` / Both |
|:--|:--|:-:|
Expand All @@ -266,6 +267,30 @@ These items can be chosen for display on the Home screen. A Nightscout Site is r
| TDD | Total Daily Dose in the last 24 hours | `Trio` |
| IAGE | Insulin Age | Both |

#### Color Thresholds

Rows that show a single number can optionally turn **yellow** or **red** when their value crosses a threshold you set. This is a purely visual cue — it never triggers an alarm. Values that are in range stay green.

To set them up, open a row's detail from the Information Display screen, turn on **Coloring**, and set the **Yellow at** and **Red at** thresholds. Each supported row starts with sensible defaults you can adjust.

The "concerning" direction is fixed per row: battery and reservoir rows color when the value is **low**, while insulin/carb load and the age rows color when the value is **high**. *LoopFollow* keeps the Red threshold on the correct side of Yellow for that direction.

Rows that support color thresholds:

| Row | Colors when | Default Yellow / Red |
|:--|:-:|:--|
| IOB | high | 3 / 5 U |
| COB | high | 30 / 60 g |
| Battery (phone) | low | 30 / 15 % |
| Pump Battery | low | 30 / 15 % |
| Pump (reservoir) | low | 20 / 10 U |
| TDD | high | 60 / 80 U |
| Rec. Bolus | high | 1 / 2 U |
| Carbs today | high | 150 / 250 g |
| SAGE (sensor age) | high | 9 / 9.5 days |
| CAGE (cannula age) | high | 2.5 / 3 days |
| IAGE (insulin age) | high | 2.5 / 3 days |

### Units and Metrics

These settings are accessed through the *Units and Metrics* row in the Settings screen. They control how glucose is displayed throughout the app, the range used for Time in Range, and how long-term glycemic and variability metrics are reported.
Expand Down