Name: CaffeineIQ - Smart Caffeine & Sleep impact Tracker
Rating: 5 (1 reviews)
Author: OKK1980

IMPORTANT: If you encounter any issues, please use the "Contact Developer" link instead of leaving a negative review. I am happy to help and fix bugs quickly!

This is an update for this CaffeineIQ App (https://apps.garmin.com/apps/7ec57617-410e-49d9-8523-0879ea888317) now supporting complications. 

Welcome to CaffeineIQ, the ultimate caffeine tracking widget for your Garmin watch. More than just a simple counter, CaffeineIQ uses a scientifically-backed pharmacokinetic model to calculate exactly how much active caffeine is currently in your bloodstream.

Whether you want to avoid afternoon crashes, optimize your workout energy, or protect your sleep quality, CaffeineIQ gives you the real-time insights you need.

### How It Works
Unlike basic trackers that only sum up what you drink, CaffeineIQ calculates two complementary metrics:
1. Total Consumed (mg): The raw sum of all caffeine you've logged today.
2. Active Level (mg): The physiological amount currently in your system — factoring in absorption time (45–60 min to peak) and your metabolic elimination rate (half-life).

### Key Features
- Real-Time Tracking: Active level and daily total on your wrist with a progress arc and color-coded zones.
- Sleep Warning System: Projects your active caffeine at bedtime and warns you before it disrupts sleep.
- Visual 24-Hour Graph: Swipe up to see your daily curve with "Now" and "Bedtime" markers.
- Customizable Presets: Log drinks using 10 configurable presets directly from your watch.
- History & Time Editing: Browse your log and correct entry times without leaving your wrist.
- Glance View: Check levels at a glance in the widget carousel.
- Complication Support: Display your active caffeine (mg) on compatible third-party watch faces that support complications. The update interval is configurable: 5, 10, 15 (default), or 30 minutes.

### Personalized Physiology
Everyone metabolizes caffeine differently. Tune the model in Garmin Connect settings:
- Sensitivity: Fast, Normal, or Slow metabolizer (half-life 3–7 h)
- Modifiers: Smoking (↓ half-life) or Oral Contraceptives (↑ half-life)
- Custom daily limit & sleep warning threshold (mg)
- Editable drink database (name, caffeine amount, visibility)
- Personal bedtime schedule

### Quick Start Tips
1. Set your bedtime and caffeine sensitivity in Garmin Connect settings before first use.
2. Log drinks as you consume them — use History to correct times if you forget.
3. Study the 24-hour graph to understand your personal caffeine curve.
4. Target lower 50 mg active at bedtime for minimal sleep disruption.
5. If readings feel off, adjust your metabolizer setting — half-life varies from 3 to 7 hours across individuals.

### Licensing
CaffeineIQ includes a 7-day free trial. After the trial, a one-time secure payment (0.99 USD + tax, credit card fee may apply) via KiezelPay unlocks the app forever. If you already purchased a license for the original CaffeineIQ (without complication support), that license is fully valid for this version — no additional purchase required.

### Scientific Sources
The pharmacokinetic model is grounded in peer-reviewed research:
- Liguori et al. (1997) — Peak absorption time ~45 min (https://pubmed.ncbi.nlm.nih.gov/9329065/)
- Fredholm BB et al. (1999) — Caffeine half-life 3–7 h in healthy adults (https://pubmed.ncbi.nlm.nih.gov/10049999/)
- Gardiner C et al. (2023) — Caffeine & sleep: systematic review & meta-analysis (https://pubmed.ncbi.nlm.nih.gov/36870101/)

### Useful Information
- Nespresso capsule caffeine data: "Alvin's Nespresso OriginalLine and VertuoLine coffee capsule info" by Alvin Bunk (https://docs.google.com/spreadsheets/d/1kZJCdTmqQla2ha3DDYyixQDIUuf9wLvt3122akBkhgM/edit?gid=745674875) — Support Alvin: https://ko-fi.com/alvinbunk

### Medical Disclaimer
*For informational purposes only — not medical advice.