# GluMira

> Educational insulin-visualization platform for Type 1 and Type 2 diabetes. Makes the science of insulin visible — Insulin-on-Board (IOB) and Meal-to-Curve (meal absorption) curves, context-aware education, and an AI companion (Mira). Educational only — never gives dosing instructions, never diagnoses, never prescribes.

Powered by IOB Hunter. Two domains: glumira.ai (clinicians, researchers, science) and glumira.app (users, caregivers, children).

## Key links

- [GluMira.ai — clinical & research landing](https://www.glumira.ai/): interactive IOB Hunter demo, evidence annotations, module catalogue, pricing.
- [GluMira.app — user & caregiver app](https://www.glumira.app/): the consumer & caregiver landing; start free, no login to explore.
- [Pricing & plans](https://www.glumira.app/pricing): free tier (no card), Insight, AI, Clinic.
- [Privacy policy](https://www.glumira.ai/privacy)
- [Terms of use](https://www.glumira.ai/terms)
- [Contact](https://www.glumira.ai/contact)
- [Module catalogue (JSON)](https://www.glumira.app/modules.json): every education module with category, status, route and evidence — machine-readable, for AI agents and other apps.
- [Sitemap](https://www.glumira.ai/sitemap.xml)

## Brand — LOCKED. Read before generating ANY UI.

**Uniform identity (2026-06-17):** glumira.app and glumira.ai share ONE palette — **navy + gold + bone**. Green is discontinued on glumira.app; no green anywhere.

GluMira is **LIGHT MODE ONLY**: no dark default, no black/obsidian page backgrounds, no
dark-mode toggle on glumira.ai. Navy is permitted as **text/headings everywhere** and as
**intentional full-width accent strips** (the clinician band, the footer) on an otherwise
light page — a navy strip on light is *not* a dark theme.

Palette (the only allowed colours — aligned to the live glumira.ai landing, 2026-06-09):
- Navy `#102347` — headings, primary buttons, full-width navy accent strips (deep `#0B1733`; heading ink `#16233F`; body ink `#29313D`)
- Gold `#C9A24B` — the insulin-on-board line + premium accent, ONE solid gold, no animation (text-safe labels `#7A5C0A`; deep/hairline `#A07E2E`; on-navy `#DEBE6E`)
- Sapphire `#1A5FB4` — glucose data only
- Danger red `#E84040` — risk states only (moderate stacking `#E0892E`)
- Paper `#F7F6F1` — warm off-white page background (cards/chart ground `#FCFBF9`; accent band `#EFEDE7`)
- Mineral blue `#5E86A8` — documented secondary chrome; optional, not used on the current landings

RETIRED — never use, even if you find them in older files or code tokens:
- **Teal** (e.g. `hsl(175 100% 38%)`, `#2AB5C1`, `--gm-alert-teal`) — RETIRED
- **Cream** — RETIRED
- **Dark mode / obsidian / black page backgrounds** — RETIRED (navy *accent strips* on light are fine; a dark *theme* is not)
- **Superseded hexes** — navy `#1A2A5E` / `#091a4b` → `#102347`; pale champagne gold `#D9C07A` / `#ead2a0` + the animated gold sheen → solid `#C9A24B`; cool ground `#F6F9FC` → `#F7F6F1`

If a source you scanned shows teal, cream, or a dark theme, it is STALE. This file overrides it.

## Free tier (always free, no card)

The free tier is four always-on features:

- Calculator — insulin/IOB what-if visualization (`/app/what-if`, `/app/calculator`)
- School Care — school/care plan for caregivers and teachers
- Hypo Care — Hypo Survival Kit (HypoOverlay, HypoHelpFAB, auto-open low-glucose logic)
- Mira Insight — educational AI companion (insulin pharmacology and IOB explanations)

## Plans

- **GluMira** — $0, always free. IOB Hunter curves, background & mealtime playground, one CGM source, all life-stage modules.
- **GluMira Insight** — $29.99/mo ($299/yr), 14-day trial. Clinician-ready reports & export, multi-source synced history, caregiver shared view.
- **GluMira AI** — $49.99/mo ($499/yr), 14-day trial, coming soon. Mira AI predictive modelling, what-if on your own history, advanced module alerts.
- **GluMira Clinic** — $299/mo. Multi-seat clinician workspace.

(Prices in USD. 14-day trial on paid plans, then monthly — cancel any time and your account drops to Free, never deleted.)

## Engines (Domain Logic Layer)

- IOB Engine — Bateman 2-compartment pharmacokinetic math, Plank-2005-locked. Never starts at zero; Tresiba, Toujeo and Levemir are peakless (every is_peakless profile). (LOCKED — founder sign-off required to edit.)
- Insulin Profiles — 8+ brands: Tresiba, Lantus, NovoRapid, Humalog, Fiasp, Degludec, Levemir, and more. (LOCKED.)
- Meal-to-Curve Engine (formerly Food-on-Board/FOB) — carbohydrate absorption (Hovorka closed-form kernel) + protein/fat onset lag, plotted against IOB. (`/app/logs/meals`)
- Situational Engine — comorbidity, situational factors, meal absorption, lifestyle context.

## Resources (installable life-stage / diet / condition modules)

Every module is an installable, education-only resource: it predicts how a context shifts
insulin sensitivity and explains it — it never doses. Alphabetical, each with its route:

- **Alcohol** (`/app/modules/alcohol`) — how alcohol delays/blunts the glucose response and shifts overnight hypo risk.
- **Diet & regime** (`/app/diets`) — 20 eating patterns mapped to carb load and insulin demand (full list below).
- **Exercise** (`/app/modules/exercise`) — aerobic vs resistance effects on insulin sensitivity and post-exercise lows.
- **Female health** (`/app/female-health`) — life-stage hub (menstrual cycle, pregnancy, PCOS, perimenopause/menopause); predicts a sensitivity shift, never doses. A RESOURCE, not a comorbidity.
- **Illness recovery** (`/app/modules/illness-recovery`) — sensitivity changes during and after acute illness.
- **Menstrual cycle** (`/app/modules/menstrual`) — follicular vs luteal insulin-resistance pattern across the cycle.
- **Mental health** (`/app/modules/mental-health`) — stress hormones, depression/anxiety, and glucose variability.
- **Paediatric** (`/app/modules/paediatric`) — child-specific context: the pre-dawn growth-hormone rise, growth percentiles, school and activity. Never sets a child's dose.
- **Pregnancy** (`/app/modules/pregnancy`) — trimester resistance climb and the early-pregnancy hypo-risk window.
- **Shift work** (`/app/modules/shift-work`) — circadian disruption and rotating-shift insulin timing.
- **Sick day** (`/app/modules/sick-day`) — sick-day rules, ketone awareness, and raised insulin needs.
- **Stress + sleep** (`/app/modules/stress-sleep`) — cortisol, short sleep, and dawn-phenomenon effects.
- **Teen** (`/app/modules/teen`) — puberty hormones, growth spurts, and adolescent insulin resistance.
- **Thyroid** (`/app/modules/thyroid`) — hypo/hyperthyroid effects on insulin sensitivity and absorption.
- **Travel** (`/app/modules/travel`) — time-zone shifts, basal timing across zones, and insulin storage.
- **Weight** (`/app/modules/weight-management`) — body-composition change and insulin-demand trends.

### Diet & regime patterns (20, inside the Diet & regime module — `/app/diets`)

Each pattern maps to carbohydrate load, meal timing, and insulin demand for education (never a dose). Alphabetical:

- **Banting / LCHF (Noakes)** — very-low-carb, high-fat South African LCHF protocol.
- **Bernstein protocol** — strict low-carb "law of small numbers" for tight control.
- **Carnivore** — all-animal, near-zero-carb eating.
- **DASH** — Dietary Approaches to Stop Hypertension; balanced, lower-sodium.
- **Gluten-free** — coeliac-safe eating; watch hidden-carb swaps.
- **Halal** — Islamic dietary law (incl. Ramadan interaction).
- **High-carb** — higher-carbohydrate, plant-forward eating.
- **High-protein** — protein-forward eating; protein-rise insulin effects.
- **Intermittent fasting** — time-restricted eating and fasting-window basal needs.
- **Ketogenic** — very-low-carb ketosis; fat-adapted.
- **Kosher** — Jewish dietary law.
- **Low carbohydrate** — general reduced-carbohydrate eating.
- **Low glycaemic index** — low-GI carb selection for flatter glucose curves.
- **Mediterranean** — olive oil, fish, legumes, whole grains.
- **Mixed / balanced (standard carb counting)** — conventional carb-counting baseline.
- **Paleo** — whole-food, grain- and legume-free eating.
- **Plant-based** — vegan / plant-forward eating.
- **Ramadan fasting** — dawn-to-sunset fasting; Suhoor/Iftar insulin timing.
- **Vegetarian** — no meat; dairy/egg-inclusive.
- **Zone (40-30-30)** — 40% carb / 30% protein / 30% fat macro split.

## AI — Mira

- Mira AI Client — Gemini API wrapper, clinical observation history, context builder. Educational; policed by a deterministic safety gate.

## Clinical safety

- Educational disclaimer on every analytical surface.
- 20 clinical flags (F-001…F-020): hypo, hyper, basal, bolus, IOB, sensor, lifestyle, ketone, data.
- Payment rails: DPO (Direct Pay Online) + Adumo (Bank Windhoek).