Mindful Coffee – Frequently Asked Questions (FAQ)

Welcome! This guide will help you understand the fascinating science of caffeine, get the most out of the Brew Journal, and dial in your perfect cup with Mindful Coffee. Whether you're a casual coffee drinker, a home espresso enthusiast, or a serious sleep optimizer, you'll find insights here that can transform your relationship with caffeine.

Brew Journal

What is the Brew Journal?

The Brew Journal is a Pro feature that lets you log every cup you make at home or order out: espresso, V60, AeroPress, Chemex, French press, moka pot, cold brew, plus tea, matcha and Gong Fu sessions. For each brew you can capture grind size, dose, water ratio, brew time, temperature, pressure, pre-infusion, bloom water, TDS, and a 1-5 rating. Over time you build a searchable history of what works — so you can replicate your best cups and skip the bad ones.

What brewing methods are supported?

Mindful Coffee ships with first-class support for:

Espresso (with pressure, pre-infusion)
V60 / pour over (with bloom water, pre-infusion)
AeroPress (standard and inverted)
Chemex
French press
Moka pot
Cold brew (long timer, hh:mm)
Drip coffee
Tea steep (green, black, oolong, white, herbal)
Matcha whisk
Gong Fu cha

Each method shows only the parameters that make sense for it — no irrelevant fields cluttering the form.

What is the Brew Guide?

The Brew Guide is a library of starting-point recipes for every supported method, baked into the app. Tap a recipe to pre-fill the brew log, then tweak from there. Over time, your own saved recipes appear in the My Recipes tab right next to the Guide — your favorites are always one tap away.

What are Smart Suggestions?

After you've logged a few brews of the same method, Mindful Coffee analyzes your past attempts and suggests adjustments to grind, brew time, and water temperature based on which brews you rated highest. The more you log, the smarter the suggestions get — it's a personalized feedback loop for dialing in your equipment.

How accurate is the caffeine estimate for tea and matcha?

The app estimates caffeine per cup based on:

The leaf type (green, black, oolong, white, herbal, matcha)
The dose (grams of leaf or matcha powder)
The steep time (longer = more caffeine extracted)
The method (Gong Fu typically uses more leaf with shorter steeps; matcha whisks the entire leaf in)

Matcha is special because you consume the whole leaf, not just an infusion — so a 1g serving of matcha can rival a small espresso shot for caffeine. The app accounts for this automatically.

Does the Brew Journal sync across my devices?

Yes — brew entries and saved recipes sync via iCloud alongside your caffeine log. Start a brew on your iPhone, finish entering it on your iPad, and review analytics on your Mac.

Is the Brew Journal free?

The Brew Journal, Brew Guide, Smart Suggestions, and Brew Analytics are Pro features. You can preview the UI for free; logging and analyzing brews requires a Pro subscription. (Caffeine tracking, sleep prediction, and basic logging remain free.)

Apple Watch, Siri & Cortisol Timing

How do I set up the Apple Watch complications?

Mindful Coffee ships two WidgetKit complications for watchOS:

Caffeine Now — your current caffeine level at a glance.
Bedtime Prognosis — when you'll be ready for sleep based on current intake.

To add them:

Make sure the Mindful Coffee Watch app is installed — open the Watch app on your iPhone → scroll to Mindful Coffee → tap Install. The Watch app should install automatically once both devices are paired.
On your Apple Watch, long-press the watch face you want to customize → tap Edit → swipe to Complications.
Tap an empty complication slot, then scroll down to Mindful Coffee and pick either Caffeine Now or Bedtime Prognosis.
Press the Digital Crown to save.

Supported families: .accessoryCircular, .accessoryRectangular, .accessoryInline, .accessoryCorner — they work on Modular, Infograph, and the Smart Stack.

How do I quick-log a drink from my Apple Watch?

Just tap the complication. A one-screen logging view opens with your Default Drink pre-filled. Spin the Digital Crown to fine-tune the mg amount, then tap Log. Done.

If you'd rather pick a different drink, the regular Mindful Coffee Watch app still works — the complication tap is the express lane for your default.

How do I set my Default Drink?

On your iPhone: Settings (gear icon top-right) → Personalization → Default Drink. Pick any drink from your catalog. The picker shows the drink name and caffeine amount, e.g. "Espresso (64 mg)".

This single setting powers:

The Apple Watch complication tap-to-log
"Hey Siri, log a coffee"
Quick-log from cortisol-window notifications

How do I use "Hey Siri, log a coffee"?

Mindful Coffee donates an App Shortcut to Siri on first launch (iOS 18+). Try any of these phrases:

"Hey Siri, log a coffee in Mindful Coffee"
"Hey Siri, log coffee with Mindful Coffee"
"Hey Siri, add coffee to Mindful Coffee"

Siri will instantly log your Default Drink without opening the app — perfect when you're driving, working out, or already mid-sip.

You can also assign the shortcut to the Action Button (iPhone 15 Pro and later) or a Home Screen widget via the Shortcuts app.

Where do I find today's caffeine timing windows?

Two ways:

Tap the cortisol chart on the Today screen. A sheet slides up showing every Best, OK, and Avoid window for today with exact start times. Tap the disclosure arrows to expand each section. The toggle at the bottom lets you show or hide the legend on the chart itself.
Look at the ☆ markers below the caffeine bars on the chart — those are the start times of today's Best caffeine windows.

What are cortisol-window alerts and how do I enable them?

A gentle local notification at the start of each Best caffeine window (when your cortisol is naturally dropping and caffeine helps most). Each notification offers a Quick Log button (logs your Default Drink instantly) and a Snooze 30 min option.

To enable:

Settings → Notifications → toggle on Cortisol-window alerts.
Make sure Mindful Coffee has notification permission (you'll be prompted on first enable, or check iOS Settings → Notifications → Mindful Coffee).

Built-in safeguards:

Quiet hours respected — nothing during your configured bedtime/wake window.
Max 2 per day — you won't get spammed even on long days.
Smart suppression — if you logged a drink in the last hour, the next alert is skipped automatically.

What is the Smart Stack relevance?

On iPhone (lock screen, StandBy, Smart Stack on the Home Screen) and on Apple Watch, the Mindful Coffee widget now hints to iOS when it should be automatically surfaced:

Morning Best window — high relevance just before your first Best caffeine window of the day.
Near bedtime + still high caffeine — maximum relevance so you see the warning.
~90 minutes before sleep-ready — medium relevance as a heads-up.

You don't need to configure anything — iOS handles the surfacing automatically once the widget is in your Smart Stack.

How does the Mindful Body integration work?

Mindful Body is the companion app for body composition, goals and progress photos. Mindful Coffee includes a Companion App card in Settings:

If Mindful Body is installed, the card shows OPEN — tap to launch it.
If not, the card shows GET — tap to open the App Store.

Caffeine data flows automatically via Apple Health: Mindful Coffee writes your caffeine intake to Health, and Mindful Body reads it from there. No manual export needed. To verify the link, log a drink in Mindful Coffee, then open the Health app → Browse → Nutrition → Caffeine — your entry should appear with "Mindful Coffee" as the source.

Understanding Caffeine

What exactly is caffeine, and how does it work?

Caffeine is a natural stimulant found in over 60 plant species, including coffee beans, tea leaves, cacao pods, and kola nuts. Plants evolved caffeine as a defense mechanism—it's actually a natural pesticide that paralyzes insects!

When you drink coffee, caffeine is absorbed through your stomach and small intestine within 45 minutes. It then crosses the blood-brain barrier and starts blocking adenosine receptors. Adenosine is your brain's "sleepiness molecule"—it builds up throughout the day and makes you feel tired. By blocking these receptors, caffeine tricks your brain into feeling alert.

But here's the catch: caffeine doesn't eliminate adenosine—it just temporarily blocks it. The adenosine keeps building up behind the scenes. When the caffeine wears off, all that accumulated adenosine floods your receptors at once, which is why you can crash hard after the effects fade.

What is caffeine half-life and why does it matter?

Caffeine half-life is the time it takes for your body to eliminate half of the caffeine you consumed. Think of it as your body's caffeine "processing speed."

The average half-life is about 5 hours, but this varies dramatically between individuals:

Fast metabolizers: 3-4 hours (lucky you!)
Average metabolizers: 5-6 hours
Slow metabolizers: 7-9 hours
Pregnant women: 12-18 hours (caffeine lingers much longer!)

Why this matters—a real example:

If you drink 200mg of caffeine (a typical large coffee) at 2 PM with a 5-hour half-life:

7 PM (5 hours): ~100mg remains
12 AM (10 hours): ~50mg remains
5 AM (15 hours): ~25mg remains

Even 25mg can reduce your deep sleep by 20%! Research shows that caffeine consumed 6 hours before bed can cut total sleep time by over an hour—even if you don't feel like it's affecting you.

The takeaway: Your subjective feeling of "I can drink coffee late and sleep fine" doesn't mean your sleep quality isn't suffering. Sleep studies consistently show caffeine reduces deep sleep even when people report falling asleep easily.

How much caffeine is in my drinks?

Caffeine content varies more than most people realize. Even the same drink from the same café can vary by 50% day to day!

Sample beverages in Mindful Coffee:

Drink	Caffeine (mg)
Espresso	63
Drip Coffee (8oz)	80
French Press	95
Green Tea	30
Black Tea	50
Matcha	70
Cola (12oz)	27
Energy Drink (8oz)	80

Some surprising facts:

Espresso has less caffeine than drip coffee – It's more concentrated, but you drink far less volume. A single espresso (63mg) has less caffeine than an 8oz drip coffee (80mg).
"Decaf" isn't caffeine-free – A cup of decaf still contains 2-15mg of caffeine. If you're highly sensitive or drink several cups, it adds up.
Tea caffeine depends on steep time – The longer you steep, the more caffeine extracts. A 1-minute steep might yield 20mg; a 5-minute steep could hit 50mg from the same tea bag.
Cold brew isn't always stronger – Despite the reputation, our Cold Brew (8oz) is 72mg. The "stronger" perception often comes from drinking larger portions.

The app includes 20+ default beverages. You can edit values or add custom drinks to match your specific brands and brewing methods.

When is the best time to drink coffee?

This is where chronobiology meets your morning routine. Your body follows a circadian rhythm—a roughly 24-hour internal clock that regulates hormones, body temperature, and alertness.

The Cortisol Connection:

Cortisol is your body's natural "alertness hormone." It follows a predictable daily pattern:

Cortisol Awakening Response (CAR): Cortisol surges 50-75% within 30-45 minutes of waking. This is your body's natural "wake-up call."
Secondary peaks: Smaller cortisol bumps occur around noon and early evening.
Lowest point: Late evening, preparing you for sleep.

Why this matters for coffee timing:

Drinking caffeine during high-cortisol periods is counterproductive:

You're already alert, so you don't get the full benefit
It builds tolerance faster
You may develop caffeine dependence more quickly

Optimal coffee timing:

Time	Why
Wait 60-90 min after waking	Let your natural cortisol peak do its work first
9:30-11:30 AM	Cortisol dips—perfect for your first coffee
1:30-3:00 PM	Post-lunch cortisol dip—ideal for second coffee
Cut-off: 8-10 hours before bed	Allows caffeine to clear your system

Mindful Coffee shows you: The cortisol rhythm chart (Pro feature) visualizes YOUR personal cortisol curve so you can time your coffee in the "valleys" for maximum effect!

Why do I feel tired after coffee sometimes?

This paradox confuses many people, but there are several scientific explanations:

1. Adenosine Rebound Remember how caffeine blocks adenosine? Your body doesn't stop producing it—adenosine builds up behind the "blocked door." When caffeine wears off (it has a half-life, so it gradually decreases), that accumulated adenosine floods through. The result? A crash that feels worse than if you'd never had caffeine at all.

2. The Dehydration Factor Caffeine is a mild diuretic, meaning it increases urine production. Even mild dehydration (1-2% of body weight) causes:

Fatigue
Reduced cognitive performance
Headaches

Solution: Drink water alongside your coffee. A good rule: one glass of water for every cup of coffee.

3. Blood Sugar Rollercoaster If you add sugar to your coffee (or pair it with pastries), you get a glucose spike followed by a crash. The caffeine masks the crash initially, but when both wear off together, you feel doubly tired.

4. Tolerance and Dependence Regular caffeine consumers develop tolerance. Your brain grows extra adenosine receptors to compensate for the blocked ones. Result? You need more caffeine just to feel "normal," and without it, you feel worse than baseline.

5. Sleep Debt Using caffeine to push through tiredness doesn't eliminate your need for sleep—it just masks it temporarily. The underlying sleep debt remains and accumulates.

The fix: Use Mindful Coffee to track patterns. Are you crashing at the same time daily? Drinking more than you realize? Consuming caffeine too late? The data reveals the pattern.

Getting Started

How do I log my first drink?

Getting started takes just seconds:

Open the app and tap the "Log" tab
Select your drink from the list (or tap "+" to create a custom one)
Adjust the amount if needed
Tap "Log" to confirm

That's it! The app instantly calculates your caffeine levels, updates your decay curve, and predicts when you'll be sleep-ready.

Pro tip: The app learns from your habits. Drinks are automatically sorted by "Last Used" or "Most Used," so your favorites rise to the top over time.

What should I set as my bedtime?

Your preferred bedtime is the time you want to actually fall asleep—not when you get into bed, start your wind-down routine, or begin scrolling your phone.

Go to Me → Preferred Bedtime and set it accurately.

Why accuracy matters:

The app calculates your "sleep-ready time"—when caffeine levels will be low enough for quality sleep. If your bedtime is wrong, all predictions will be off.

Example: You want to be asleep by 11 PM but usually get in bed at 10:30 PM. Set bedtime to 11:00 PM, not 10:30 PM.

Bonus: The app can send you alerts if you're approaching bedtime but your caffeine levels are still high—giving you time to adjust your evening plans.

Do I need to log every single drink?

Yes—consistency is key to accuracy!

Think of caffeine tracking like a bank account. If you only log some deposits, your "balance" (current caffeine level) will be wrong, and all projections become meaningless.

What happens when you miss drinks:

Your caffeine curve understates reality
Sleep predictions become overly optimistic
Correlation data becomes unreliable
You can't identify patterns

Tips for building the logging habit:

Enable Smart Daily Reminders – The app only notifies you on days you haven't logged yet. No spam if you're already tracking!
Use the Apple Watch app – Single tap logging without pulling out your phone. Perfect for busy mornings.
Build a streak – The app tracks consecutive logging days. Many users find this surprisingly motivating—breaking a 30-day streak hurts!
Log immediately – The best predictor of logging success is logging while drinking, not "I'll do it later."

What if I forget to log a drink immediately?

Life happens! Here's how to handle it:

Option 1: Log it late (same day) Just log when you remember. The app uses the current time, which is usually close enough for same-day drinks.

Option 2: Add with custom timestamp Go to History → Add Entry and set the exact time. Perfect for "I forgot to log my morning coffee and it's now 3 PM."

Option 3: Let it go (occasional) If you occasionally miss a drink, it's not the end of the world. One missing data point won't ruin your overall patterns. Just try to be consistent going forward.

For best accuracy: Log within 30 minutes of consumption. The app assumes immediate absorption, so timing matters for the decay curve.

Using Mindful Coffee Effectively

How do I interpret the "Today" screen?

The Today screen is your caffeine command center. Here's what each element tells you:

1. Coffee Cat – Your Caffeine Avatar

Coffee Cat is more than cute—it's an instant visual indicator of your caffeine state:

Sleepy/Calm Cat: Low or no caffeine. Good for evening.
Alert Cat: Moderate caffeine. You're in the productive zone.
Wired/Jittery Cat: High caffeine. Consider holding off on the next drink.

The cat changes dynamically as your caffeine levels rise and fall throughout the day.

2. Caffeine in Body (mg)

This number shows your current estimated caffeine level—not what you drank today, but what's actively circulating in your system right now.

This number constantly decreases as your body metabolizes caffeine (based on your half-life setting). After your last drink, you'll watch it drop over the following hours.

3. Sleep-Ready Time

Perhaps the most useful metric: when will your caffeine be low enough for quality sleep?

This is calculated based on:

Your current caffeine level
Your personal half-life setting
Your sleep threshold (how much caffeine you can tolerate and still sleep well)
Your preferred bedtime

Red text = You're past your bedtime and caffeine is still high. Consider adjusting tomorrow's intake.

4. Total Today

Your cumulative consumption since midnight. Useful for staying under daily limits (recommended: 400mg for healthy adults).

5. The Caffeine Curve Chart

The visual heart of the app. This shows:

Past consumption (vertical spikes when you logged drinks)
Current level (where the curve is now)
Future projection (how your levels will decline)
Your bedtime (vertical line)
Sleep threshold (horizontal line)

Where the declining curve crosses your sleep threshold tells you your sleep-ready time visually.

Power user tip: Check this screen before each drink, not just after logging. It helps you make informed decisions about whether you really need that next coffee.

What is the "What-If" simulator?

The What-If simulator lets you preview the future before committing. It's like a crystal ball for your caffeine decisions.

How it works:

When you're on the drink selection screen, the app shows what would happen if you drank that beverage right now:

New projected caffeine level
Updated sleep-ready time
Visual curve preview

You haven't logged anything yet—you're just exploring.

Practical example:

It's 3 PM. You want to sleep by 11 PM. You're considering coffee.

Option	Preview Shows	Decision
Large Coffee (150mg)	Sleep-ready: 1:30 AM	Skip it
Small Coffee (80mg)	Sleep-ready: 11:45 PM	Risky
Green Tea (35mg)	Sleep-ready: 10:00 PM	Good choice
Decaf (5mg)	Sleep-ready: 8:30 PM	Safe bet

The simulator empowers you to make choices aligned with your sleep goals, not just your immediate cravings.

Can I customize the widget?

Yes. Mindful Coffee includes widget customization so you can make the Home Screen experience feel more personal and useful.

What you can customize:

Choose modern widget styles like Midnight, Warm Latte, Focus Blue, and Forest
Personalize the Quick Log buttons shown in the medium widget
Keep your favorite drinks one tap away right from the Home Screen

Why this matters: The widget is meant to be more than a passive display. With customization, it becomes a faster, more personal caffeine dashboard that fits both your taste and your routine.

Good setup ideas:

Use one Quick Log button for your most recent drink
Pin your go-to morning drink as a custom shortcut
Pick a style that looks great on your wallpaper but still keeps the caffeine number easy to scan

Widget customization is available as a Pro feature.

How do I use daily logging streaks?

Streaks tap into a powerful psychological principle: loss aversion. Once you've built a streak, you're motivated to maintain it.

What counts:

Log at least one caffeinated drink per day, OR
Log a "No caffeine today" entry to mark intentional zero days

Why streaks matter:

Data quality – Consistent logging means reliable patterns
Habit formation – It takes ~66 days to form a habit (not 21, as commonly believed)
Self-awareness – Streaks keep caffeine consumption top-of-mind
Gamification – Simple but effective motivation

Streak milestones to celebrate:

7 days: You're building a habit
30 days: Caffeine awareness is becoming automatic
100 days: You're a tracking pro

Don't let perfectionism kill your streak: If you genuinely had no caffeine, log a zero-caffeine entry. The goal is awareness, not maximum consumption.

What is the Sleep Insights Card?

This card connects two crucial data streams: what you drank and how you slept.

What it shows:

Last night's sleep duration (from Apple Health)
Yesterday's total caffeine intake
Your average sleep duration for comparison

Why it's powerful:

You make caffeine decisions in the morning/afternoon but experience consequences at night. By the time you sleep poorly, you've forgotten what you drank 10 hours ago.

The Sleep Insights Card closes this feedback loop. Every morning, you see:

"I had 350mg yesterday and slept 5.5 hours"
"My average is 7 hours"
Immediate connection: yesterday's choices affected last night's sleep

How to use it:

Check it every morning as part of your routine
Notice patterns over time
Adjust today's intake based on what you learned

This transforms caffeine from "mindless habit" to "informed choice."

How does the Grouped History View work?

Scrolling through months of individual entries gets tedious. The Grouped History View makes navigation effortless:

Structure:

Current month: Fully expanded, showing every entry with times and amounts
Previous months: Collapsed into summaries showing total consumption and entry count
Tap any month to expand and see individual entries

What you can learn:

"I drank 12,400mg of caffeine in October—that's averaging 400mg/day"
"August was lower—I was on vacation and more relaxed"
"My consumption has crept up 15% over the last quarter"

Pro tip: Compare months to see seasonal patterns. Many people drink more caffeine in winter (darker mornings, comfort drinks) and less in summer.

Advanced Features

What is the Personal Metabolism Assistant? (Pro)

Here's a fascinating fact: two people can drink the same coffee at the same time, and one might be sleep-ready by 10 PM while the other is wired until 2 AM. The difference? Genetics.

The Personal Metabolism Assistant is an interactive calibration tool that learns YOUR unique caffeine processing speed.

How it works:

Rather than asking you to guess technical values, the assistant presents real-world scenarios:

"After a mid-afternoon coffee, how long until you feel the effects wear off?"
"How does late caffeine affect your sleep?"
"Do you feel jittery with a single cup, or does it take more?"

Based on your answers, the assistant calculates:

Your personal half-life (how quickly you metabolize caffeine)
Your sensitivity level (how strongly caffeine affects you)
Your sleep threshold (how much caffeine you can tolerate and still sleep)

When to recalibrate:

Your caffeine metabolism isn't fixed. Run the assistant again if:

You're pregnant or recently gave birth (pregnancy can triple half-life)
You started or stopped hormonal contraceptives
You quit or started smoking
You began taking new medications
You've noticed predictions becoming less accurate
Significant time has passed (metabolism slows with age)

The science: Your metabolism is primarily controlled by the CYP1A2 enzyme in your liver. Genetic variations in this enzyme create "fast metabolizers" (3-4 hour half-life) and "slow metabolizers" (6-7 hours or longer). The assistant helps you discover which you are.

What is Cortisol Rhythm Modeling? (Pro)

In 2007, researcher Steven Miller at Bethesda's Uniformed Services University discovered something counterintuitive: drinking coffee first thing in the morning might be a waste of caffeine.

Why? Cortisol—your body's natural alertness hormone.

The Cortisol Awakening Response (CAR):

When you wake up, your body triggers a cortisol surge that peaks about 30-45 minutes after opening your eyes. This natural spike is designed to get you alert and functioning.

Here's the insight: if you drink coffee during this peak, caffeine competes with cortisol for the same mental effects. You're essentially stacking stimulants—and your body may develop tolerance faster because it doesn't need the caffeine when cortisol is already high.

The cortisol rhythm throughout the day:

Time	Cortisol Level	Coffee Strategy
Wake + 30 min	Peak	Wait! Ride the natural wave
9:30-11:30 AM	Dip	Excellent coffee window
12-1 PM	Secondary peak	Maybe wait
1:30-5 PM	Declining	Good window (but watch sleep)
Evening	Low	Avoid caffeine

How to use this in the app:

Enable cortisol modeling in Me → Cortisol Settings
Set your typical wake time
The Today screen overlay shows your personal cortisol curve
Time your coffee during the "valleys" between peaks

Customization: Not everyone follows the textbook cortisol pattern. Early risers, shift workers, and night owls have different rhythms. Adjust the CAR peak timing and amplitude to match your body's actual pattern.

Result: You use less caffeine for the same alertness—and may even reduce your tolerance over time.

Where does my wake time come from?

If you grant access to Apple Health sleep data, Mindful Coffee derives your typical wake time automatically. There is no setup step for this.

It is a median, not this morning's alarm.

The app looks at up to 14 nights of sleep data and takes the median wake time. That distinction matters more than it sounds: one early flight, one weekend lie-in, or one night the watch was on the charger should not redraw your entire cortisol curve. A median ignores those outliers and tracks the rhythm you actually keep.

What if the detected time looks off?

You can always override it manually in Settings and pin a fixed wake time.
If you have no sleep data in Health, or you have not granted access, the app falls back to a sensible default until you set one yourself.
Shift workers and people with genuinely irregular schedules usually get better results from a manual value, since a median across scattered wake times describes nobody's actual morning.

Because the cortisol model keys off this time, it is worth a glance when you first set things up.

How does the Cortisol Model actually work? (The Science)

Mindful Coffee uses a sophisticated two-phase mathematical model to simulate your body's cortisol rhythm throughout the day. This isn't just a static chart—it's a dynamic calculation that updates in real-time based on your wake time and caffeine intake.

Phase 1: The Cortisol Awakening Response (CAR)

The model simulates the dramatic morning cortisol surge using a gamma-distribution-inspired curve. Here's what happens mathematically:

When you wake up, cortisol rises from your nighttime baseline (typically ~50 nmol/L) to a morning peak (typically ~600 nmol/L). The formula uses an exponential rise-and-fall pattern:

Cortisol = BaseLevel + Amplitude × (t/peakTime) × e^(1 - t/peakTime)

Where t is time since waking. This creates a natural curve that:

Rises sharply in the first 30-45 minutes
Peaks at your CAR peak time (configurable, default 45 min)
Begins declining after the initial surge

The CAR phase typically lasts 2-3 hours, during which your body provides natural alertness without needing caffeine.

Phase 2: The Diurnal Decline

After the CAR phase ends, cortisol follows a cosine-based decay function that models the natural afternoon decline. The curve gradually returns toward your nighttime baseline level by evening, following your circadian rhythm.

This two-phase approach mirrors what endocrinologists observe in clinical settings—your cortisol doesn't just spike and crash; it follows a predictable biological pattern tied to your internal clock.

The Caffeine-Cortisol Interaction

Here's where Mindful Coffee gets really sophisticated. Each caffeine consumption creates a temporary cortisol spike that overlays on your natural rhythm. The app calculates:

Spike = (caffeine_mg × sensitivity) × (t/peakTime) × e^(1 - t/peakTime)

This models the scientifically-documented phenomenon that caffeine stimulates your adrenal glands to release additional cortisol. The spike:

Peaks approximately 45 minutes after consumption
Decays over the following hours
Stacks with your natural cortisol level

Why this matters: When you drink coffee during your natural CAR peak, you're essentially adding caffeine-induced cortisol on top of already-high natural cortisol. This can:

Contribute to the jittery, anxious feeling some people get from morning coffee
Train your body to expect artificial stimulation, building tolerance
Waste the alertness potential of your caffeine

Five Configurable Parameters:

Every body is different. The app lets you fine-tune:

Parameter	Default	Range	What It Controls
Nighttime Base Level	50 nmol/L	20-100	Your lowest cortisol during deep sleep
Morning Peak Level	600 nmol/L	400-800	How high your natural morning spike reaches
CAR Peak Time	0.75 hours	0.25-1.5	When after waking your peak occurs
Morning Rise Duration	3.0 hours	2.0-5.0	How long the elevated CAR phase lasts
Caffeine Sensitivity	2.5	0.5-4.0	How strongly caffeine spikes your cortisol

Who should adjust these settings?

Night owls may have a delayed CAR—increase CAR Peak Time
Early risers often peak faster—decrease CAR Peak Time
High-stress individuals might have elevated baselines—increase Base Level
Caffeine-sensitive people should increase Caffeine Sensitivity to see more pronounced spike effects
Those with adrenal fatigue concerns may have blunted CAR—decrease Peak Level

The Color-Coded Timing Legend:

When enabled, the chart displays three zones:

🟢 Best – Cortisol is in a natural dip; caffeine will be most effective
🟡 OK – Moderate cortisol; caffeine will work but isn't optimal
🔴 Avoid – High natural cortisol; drinking now wastes caffeine and builds tolerance

Optimal Coffee Windows:

Based on your wake time and bedtime, the app calculates personalized optimal windows. For someone waking at 6:45 AM:

First window: 8:45-10:45 AM – After CAR subsides, before lunch
Second window: 12:45-2:45 PM – Post-lunch dip, but early enough for sleep

These windows shift automatically based on YOUR wake time—not generic advice.

The Research Behind It:

This model draws from peer-reviewed endocrinology research on the HPA (hypothalamic-pituitary-adrenal) axis. Key studies include work on:

The Cortisol Awakening Response and its role in alertness
Caffeine's effect on adrenal cortisol secretion
Circadian variation in cortisol and its interaction with stimulants

For the full scientific background, tap "Read the Science Behind This Model" in the Cortisol Settings screen, which links to our detailed research documentation.

How do Sleep Correlation Insights work?

We all suspect that coffee affects our sleep, but suspicion isn't data. The Sleep Correlation feature turns your personal experience into quantifiable insights.

The power of personal data:

Population studies tell us that caffeine disrupts sleep. But they can't tell you:

How much caffeine YOUR body can handle before sleep suffers
Whether you're more sensitive than average
If timing matters more than amount for your body

Sleep Correlation bridges that gap by analyzing YOUR data.

What it calculates:

The feature cross-references two data streams:

Your logged caffeine (from this app)
Your actual sleep (from Apple Health)

Then it buckets your days by caffeine amount and calculates average sleep for each bucket:

Daily Caffeine	Your Avg Sleep	Sample Size
0-100mg	7.8 hours	12 days
100-200mg	7.4 hours	28 days
200-300mg	6.9 hours	35 days
300mg+	6.1 hours	15 days

Interpreting your results:

Clear downward trend: Caffeine is measurably affecting your sleep
Flat across buckets: Caffeine might not be your sleep issue (look at timing instead)
Threshold effect: Sleep drops sharply above a certain amount (that's your personal limit)

Setup requirements:

Apple Health sleep data access
At least 2-3 weeks of consistent logging
Some variation in daily intake (same amount every day = no correlation possible)

Pro tip: Use the insight to set your daily caffeine budget. If your data shows sleep drops above 200mg, that's YOUR number—regardless of what guidelines say.

How does Resting Heart Rate Correlation work? (Pro)

Same idea as Sleep Correlation, but for your cardiovascular baseline.

The hypothesis it tests:

Caffeine is a stimulant. On average, it nudges heart rate up. But "on average" doesn't tell you what it does to YOUR resting heart rate, day after day. Resting HR Correlation answers that with your own data.

What it calculates:

The feature cross-references two data streams:

Your logged caffeine (from this app)
Your resting heart rate (from Apple Health, typically captured by Apple Watch overnight)

Then it buckets your days by caffeine amount and shows the average resting HR for each bucket:

Daily Caffeine	Your Avg Resting HR	Sample Size
0-100mg	58 bpm	12 days
100-200mg	60 bpm	28 days
200-300mg	62 bpm	35 days
300mg+	65 bpm	15 days

Interpreting your results:

Clear upward trend: Higher caffeine days correlate with a higher resting HR baseline
Flat across buckets: Your cardiovascular system shrugs off caffeine within the range you consume
Step change above a threshold: Your body tolerates caffeine up to a point, then resting HR jumps

Why resting HR (not active HR)?

Active heart rate jumps for a hundred reasons (workout, stairs, stress). Resting HR is captured during sleep or long quiet periods and is one of the cleanest single-number indicators of recovery and cardiovascular load. Trends in resting HR are what athletes and longevity researchers watch closely.

Setup requirements:

Apple Watch (or other Apple Health source that writes resting HR)
Apple Health "Heart Rate" / "Resting Heart Rate" read permission for Mindful Coffee
At least 2-3 weeks of consistent caffeine logging
Some variation in daily intake (same amount every day = no correlation possible)

Privacy: Same as Sleep Correlation — all calculation happens on-device. Your heart rate data never leaves your iPhone.

Pro feature: Resting HR Correlation Analysis is a Pro feature. Sleep Correlation is included for everyone.

How does HealthKit integration work? (Pro)

Apple's HealthKit is the central nervous system of health data on iPhone. Mindful Coffee connects to it for bidirectional data flow.

Every logging surface feeds the same picture. Drinks logged in the app, from the Brew Log, on Apple Watch, imported from Apple Health, or brought in via CSV all land in one dataset. Your charts, widgets, complications and correlations read from that single source, so it does not matter where you logged something.

What gets written (automatically):

Data Type	Details
Caffeine	Amount in mg per drink
Water/Fluids	Volume in ml (for hydration tracking)

Every drink you log creates a timestamped entry in Apple Health. This means:

Other apps can see your caffeine intake
Your doctor could review it (if you share Health data with them)
Caffeine appears in your overall health picture

What gets read:

Data Type	Use Case
Sleep Analysis	Powers the Sleep Correlation feature
Resting Heart Rate	Powers the Resting HR Correlation feature (Pro)
Caffeine (from other apps)	One-time import from Starbucks app, etc.

The magic of the ecosystem:

Because Mindful Coffee writes to HealthKit, you can:

See caffeine on your Apple Watch complications
Review caffeine in the Health app alongside other metrics
Export via Apple Health's built-in export feature
Let Shortcuts automations access your caffeine data

Privacy architecture:

HealthKit data stays in Apple's encrypted silo on your device. Mindful Coffee can only access what you explicitly permit, and Apple enforces these boundaries at the OS level. We couldn't read your heart rate even if we wanted to—you haven't granted that permission.

How do CSV Import/Export work? (Pro)

Sometimes you need to break out of the app—for backups, analysis, or data portability.

Export: Your data, your way

CSV (Comma-Separated Values) is the universal language of data. Export creates a file you can open in:

Excel, Numbers, Google Sheets
Python/R for advanced analysis
Any database tool
Plain text editors

Export format:

date,time,caffeine_mg,drink_name,notes
2024-01-15,08:30,95,"Medium Coffee",""
2024-01-15,14:15,35,"Green Tea","afternoon slump"

Import: Migrate from anywhere

Moving from another caffeine tracking app? Prepare your data in the same CSV format, and import it. Historical data preserves:

Accurate lifetime statistics
Pattern analysis going back months/years
Continuity for sleep correlation

Practical uses:

Device migration: Export → get new phone → import
Analysis projects: "Let me see my caffeine trends in Python"
Research contribution: Share anonymized data with sleep researchers
Backup before experiments: "I'm trying a caffeine detox—let me save my current data"

Pro tip: Set a calendar reminder to export monthly. It takes 30 seconds and ensures you never lose data.

Troubleshooting & Common Issues

When predictions don't match reality, it's usually fixable. Here's a systematic approach to common problems.

The sleep-ready time seems wrong

This is the most common issue—and it almost always comes down to calibration.

Understanding the math:

Sleep-ready time is calculated from three inputs:

Current caffeine level (from your logged drinks)
Your half-life setting (how fast you metabolize)
Your sleep threshold (how much caffeine you can tolerate and sleep)

If any of these is wrong, the prediction will be wrong.

Diagnosis and fixes:

Symptom: Sleep-ready time is too late (app is too conservative)

Your actual half-life is shorter than the app thinks
Solution: Reduce half-life setting (try 4 hours instead of 5)
Or: You might tolerate more caffeine than the app assumes—increase sleep threshold

Symptom: Sleep-ready time is too early (you can't actually sleep then)

Your actual half-life is longer than the app thinks
Solution: Increase half-life setting (try 6 hours instead of 5)
Or: You're more caffeine-sensitive—decrease sleep threshold

The nuclear option: Run the Personal Metabolism Assistant from scratch. It recalibrates everything based on fresh self-assessment.

Things that change metabolism:

Pregnancy (half-life can triple!)
Hormonal contraceptives
Smoking status changes
New medications (especially some antibiotics)
Significant weight changes
Age (metabolism slows gradually)

My caffeine curve looks weird

The curve is a visualization of exponential decay. If it looks wrong, something in the underlying data is off.

Spikes going in wrong direction or weird shapes:

You may have logged a drink with negative caffeine (data corruption)
Fix: Go to History, find the weird entry, delete it

Curve drops to zero too fast:

Half-life is set unrealistically low
Normal range: 3-7 hours (average is 5)
Below 3 hours is extremely rare (unless you're a heavy smoker)

Curve barely drops at all:

Half-life is set unrealistically high
Above 7 hours is uncommon (though possible with certain medications or pregnancy)

Starting caffeine seems way too high:

You may have duplicate entries (same drink logged twice)
Check History for duplicate timestamps
Or: HealthKit imported duplicates—review imported entries

Curve doesn't match what you drank:

Drink caffeine amounts may be wrong in your custom beverages
A "large coffee" varies from 100mg to 300mg depending on source
Verify your custom drinks have accurate caffeine values

Sleep correlation shows no data

This feature requires specific conditions to work.

Requirements checklist:

Apple Health sleep data exists
- Open the Health app → Browse → Sleep
- You should see sleep records from your Apple Watch, sleep app, or manual entries
- No sleep data = no correlation possible
Mindful Coffee has permission to read it
- Settings → Privacy → Health → Mindful Coffee
- "Sleep Analysis" must be enabled
Sufficient data volume
- Need at least 14 days of paired data (caffeine + sleep for same day)
- More data = more reliable correlations
Variation in consumption
- If you drink exactly 200mg every single day, there's nothing to correlate
- The feature needs different caffeine amounts to compare sleep outcomes

Still not working?

Try revoking and re-granting Health permissions. Sometimes the iOS permission system gets stuck.

Resting HR correlation shows no data (Pro)

Similar troubleshooting to Sleep Correlation, with a few extras specific to heart-rate data.

Requirements checklist:

Resting heart rate exists in Apple Health
- Open the Health app → Browse → Heart → Resting Heart Rate
- Resting HR is normally written by Apple Watch after a few nights of wear
- No Apple Watch and no third-party source = no resting HR to correlate
Mindful Coffee has permission to read it
- Settings → Privacy & Security → Health → Mindful Coffee
- "Heart Rate" / "Resting Heart Rate" must be enabled
Sufficient data volume
- Need at least 14 days of paired data (caffeine + resting HR for the same day)
- More data = more reliable correlations
Variation in consumption
- If you drink exactly the same amount every day, there is nothing to correlate against

Still not working?

Wear your Apple Watch for at least 3-4 nights so Apple has enough data to calculate a daily resting HR baseline
Make sure Sleep Tracking or background heart-rate sampling is enabled on the watch
Revoke and re-grant Health permissions if values look stuck

The app isn't sending reminders

Notification delivery on iOS is more complex than it seems. Here's the debugging checklist:

Layer 1: App Settings

Open Mindful Coffee → Me → Notifications
Reminders must be explicitly enabled
Check the reminder time is set correctly

Layer 2: iOS Settings

Settings → Notifications → Mindful Coffee
"Allow Notifications" must be ON
Check that your notification style isn't set to "None"

Layer 3: Logic

The app may intentionally skip reminders if you've already logged today
Reminders are meant to prompt logging when you forget, not nag when you remember

Layer 4: Focus modes

If you have Focus modes enabled (Work, Personal, etc.), check if Mindful Coffee is allowed through
Settings → Focus → [Your focus] → Apps → Allow Notifications

Testing: Delete all of today's entries, make sure it's past your reminder time, and wait. If you still get nothing, work through the layers above.

Streak broke but I logged yesterday

Time is tricky. Here's what might have happened:

Timezone issues:

If you traveled across timezones, a drink logged at 10 PM in Tokyo might register as a different day in your home timezone
The app uses your device's current timezone for day boundaries

Midnight edge cases:

A drink logged at 12:15 AM counts for the NEW day, not the previous day
If you meant to log for "yesterday," edit the entry's timestamp

Clock/calendar issues:

If your device's date/time was wrong and then corrected, entries might be on unexpected days

Prevention: Try to complete logging before 11 PM. This builds in a buffer for timezone confusion and midnight edge cases.

Science & Personalization

Why is everyone's caffeine metabolism different?

In 1962, researchers first identified the CYP1A2 enzyme—and opened a window into understanding why your friend can drink espresso at 9 PM and sleep like a baby while you're staring at the ceiling.

The genetic lottery:

The CYP1A2 gene comes in variants. Depending on which you inherited:

Metabolizer Type	Half-Life	Population %	Effect
Ultra-fast	2-3 hours	~10%	Can drink late, clear caffeine quickly
Fast	3-4 hours	~40%	Normal-to-quick metabolism
Slow	5-7 hours	~45%	Caffeine lingers, affects sleep more
Ultra-slow	7-9+ hours	~5%	Very sensitive, one coffee lasts all day

You can't change your genes, but you CAN adapt your behavior once you know your type. That's what the Personal Metabolism Assistant helps you discover.

Lifestyle factors that modify metabolism:

Beyond genetics, your environment and habits shift your half-life:

Factor	Effect on Half-Life	Mechanism
Smoking	Decreases 30-50%	Smoke induces CYP1A2 production
Pregnancy	Increases 200-300%	Hormones suppress enzyme activity
Oral contraceptives	Increases 50-100%	Estrogen inhibits CYP1A2
Grapefruit	Increases modestly	Compounds inhibit liver enzymes
Cruciferous vegetables	Decreases modestly	Compounds induce CYP1A2
Heavy alcohol use	Variable	Liver changes affect processing

The practical implication:

There's no "correct" caffeine limit that works for everyone. The 400mg/day FDA guideline is a population average. Your personal limit might be 200mg or 600mg depending on your unique physiology.

Mindful Coffee helps you discover YOUR number.

What's a "safe" daily caffeine limit?

Let's put this question in context.

Caffeine is the most widely consumed psychoactive substance on Earth. About 90% of American adults consume it daily. It's been part of human culture for over 1,000 years. So while it's a drug, it's an unusually well-studied and well-tolerated one.

Official guidelines:

Group	Recommended Max	Source
Healthy adults	400mg/day	FDA, EFSA
Pregnant/breastfeeding	200mg/day	WHO, ACOG
Adolescents (12-18)	100mg/day	American Academy of Pediatrics
Children (<12)	Avoid or minimal	AAP

But guidelines aren't destiny:

These numbers are conservative population guidelines. They're designed so that most people won't experience negative effects.

Your personal limit might be different based on:

Genetic metabolism (slow metabolizers may need less)
Anxiety sensitivity (caffeine can trigger or worsen anxiety)
Sleep quality goals (if you want 8 hours, you may need less)
Cardiovascular conditions (consult your doctor)
Medication interactions (some drugs potentiate caffeine)

The Mindful Coffee approach:

Rather than blindly following a number, use Sleep Correlation data to find YOUR threshold—the amount above which your sleep measurably suffers. That's your personal "safe" limit.

For many people, it's not about total milligrams but about timing. 200mg at 6 AM might be fine; 200mg at 2 PM might not be.

How accurate is the app?

Honesty time: Mindful Coffee is a model, and all models are wrong—but some are useful.

What the app does well:

Relative comparisons: "I drank more yesterday than today" is highly accurate
Timing guidance: "Don't drink now if you want to sleep by 11" is reliable directional advice
Trend analysis: Week-over-week and month-over-month patterns are meaningful
Decision support: Helping you think before you drink

Sources of uncertainty:

Factor	Uncertainty	Notes
Individual metabolism	±2 hours	Half-life varies by person
Caffeine content	±20-30%	Even same drink varies batch to batch
Absorption rate	±30 minutes	Food in stomach slows absorption
Sleep threshold	Personal	Some people sleep with 30mg, others need 0mg

Example of how uncertainties compound:

You log a "medium coffee" as 100mg, but:

It might actually be 80-120mg (preparation variance)
You might metabolize at 4 hours instead of the 5 you set (individual variance)
You might be able to sleep with 25mg instead of the 20mg threshold (personal tolerance)

The prediction could be off by 30-60 minutes as a result.

Philosophy:

Think of Mindful Coffee like a weather forecast. It's based on solid science and your personal data, but it's a prediction, not a measurement. Use it to guide decisions, not as absolute truth.

The more you calibrate it (Personal Metabolism Assistant, reviewing predictions vs. reality), the more accurate it becomes for YOU.

Should I quit caffeine completely?

Probably not—unless you have a specific medical reason.

The case FOR caffeine (in moderation):

Research consistently shows cognitive and health benefits:

Enhanced alertness and concentration
Improved physical performance (endurance and strength)
Reduced risk of Parkinson's disease
Reduced risk of Type 2 diabetes
Reduced risk of certain liver conditions
Antioxidant properties
Mood enhancement (dopamine pathway activation)

The case AGAINST excessive caffeine:

Sleep disruption (the big one)
Increased anxiety in sensitive individuals
Dependency and withdrawal symptoms
Blood pressure effects in some people
Can worsen certain heart arrhythmias

The Mindful Coffee philosophy:

The goal isn't abstinence—it's intentionality.

Mindless Caffeine	Mindful Caffeine
Drink because it's there	Drink because you decided to
Ignore the clock	Consider the timing
Wonder why you can't sleep	Understand the cause and effect
Same amount every day	Adjust based on needs

Most people don't need to quit. They need to:

Know what they're consuming (tracking)
Time it appropriately (not too late)
Stay under their personal threshold (not too much)
Allow occasional caffeine-free days (prevent tolerance escalation)

Can I use this app if I don't drink coffee?

Absolutely. Despite the name, Mindful Coffee tracks all caffeine sources.

The hidden caffeine landscape:

You might consume more caffeine than you realize:

Source	Typical Caffeine	Notes
Espresso shot	63mg	Concentrated but small volume
Drip coffee (12 oz)	95-200mg	Varies wildly by brewing
Black tea (8 oz)	40-70mg	Steeping time matters
Green tea (8 oz)	25-50mg	Also contains L-theanine
Matcha (1 tsp)	70mg	Concentrated green tea
Cola (12 oz)	35mg	Less than coffee, still significant
Energy drink (16 oz)	150-300mg	Often more than coffee
Dark chocolate (1 oz)	12mg	Adds up if you snack
Pre-workout supplement	150-300mg	Often very high
Caffeine pill	100-200mg	Precise but powerful
Decaf coffee (12 oz)	2-15mg	Not truly zero

Tea drinkers:

If you primarily drink tea, you'll love this app. Many tea drinkers underestimate cumulative caffeine. Five cups of black tea = one large coffee. The app helps you see the big picture.

Energy drink consumers:

This app is especially valuable for you. Energy drinks often contain 2-3x the caffeine of coffee but are marketed casually. Tracking reveals the true impact.

Customize your drink list:

Add your specific beverages with accurate caffeine values. The app comes with common defaults, but YOUR regular drinks might differ.

How does this app respect my privacy?

In an era of surveillance capitalism, we took a different path.

Architectural privacy:

Mindful Coffee is designed so that collecting your data isn't just against our policy—it's technically impossible.

Data Type	Where It Lives	Who Can Access
Your consumption logs	On your device only	Only you
Your settings	On your device only	Only you
HealthKit data	Apple's encrypted silo	Apps you permit
Analytics	Doesn't exist	Nobody
User accounts	Don't exist	N/A

What this means:

If someone subpoenaed us for your data, we'd have nothing to give
We can't sell what we don't have
A data breach can't expose what was never collected
You can delete everything by deleting the app

HealthKit specifics:

When you grant HealthKit access, you're granting access to Apple's encrypted health database on your device. This data is protected by iOS at a system level—separate from regular app data, encrypted at rest, and controlled by you.

Export = ownership:

You can export all your data to CSV anytime. This is YOUR data. Take it anywhere, analyze it, delete it, share it with a doctor—whatever you want.

No ads, ever:

Ad-supported apps are incentivized to track you (more data = better ad targeting). We use a straightforward premium model instead. You pay for Pro features; we provide them. No third parties involved.

Our privacy promise:

Your caffeine consumption is personal health data. It should be private. We built the app to make sure it is.

FilesExpand file tree

FAQ.md

Latest commit

History