The Ketosis Battery

One number for "am I in ketosis?" — plus the Carb Tank, hidden-carb warnings, and the Stats screen behind it.

Most of KetoLens exists to feed one number: the Ketosis Battery. It's our best estimate of how likely you are to be in ketosis right now, and it sits front and centre on your home screen. Here's what it means and what moves it.

Your home dashboard

The KetoLens home screen with the Ketosis Battery at the top, an Insights teaser, the Carb Tank reading 61 of 50g, and macro tiles for fat, protein, fibre and calories.
The home screen, top to bottom.

The home screen stacks four things:

  • Ketosis Battery — the big score, a colour-coded bar, and a one-line verdict.
  • Insights — personalised cards that unlock as you log (more in the diary & insights guide).
  • Carb Tank — net carbs used vs your daily goal.
  • Macro tiles — fat, protein, fibre, and calories so far today.

Tap View details → on the battery to jump to the full Stats screen.

What the 0–100 score means

The battery runs from 0 to 100. Low means we're confident you're not in ketosis; high means we're confident you are. The colour and the status label move with it:

  1. 75–100 · In Ketosis (teal) — "Great job! Your recent intake supports ketosis."
  2. 55–74 · Possibly in Ketosis (lime) — "Looking good — keep those carbs low!"
  3. 45–54 · On the Borderline (amber) — "Could go either way."
  4. 25–44 · Not in Ketosis (orange) — "Recent carb intake makes ketosis unlikely."
  5. 0–24 · Not in Ketosis (red) — "Significant carbs detected."
It's guidance, not a blood test

The battery is an estimate from your food log, not a measurement of your actual blood ketones. Everyone's metabolism is different. Want certainty? Log a ketone reading — a real measurement overrides the food-based guess.

What charges & drains it

The score looks at roughly the last 72 hours of eating, with recent meals weighted more heavily than old ones. In plain terms:

Charges it ▲

Low net carbs · a high share of fat in your calories · ketone readings in the 0.5–3.0 mmol/L range · logging consistently within your goal day after day.

Drains it ▼

Net carbs over your goal · flagged hidden carbs · alcohol in the last 48 hours · very low ketone readings · long stretches with nothing logged.

"Early Estimate" and "Rough Estimate"

New accounts (or days with very little logged) show Early Estimate or Rough Estimate instead of a confident verdict — the battery is honest about not having enough to go on yet. Log a few meals and it firms up.

Why did my score drop overnight?

The score decays if you stop logging — no meals in 24 hours and it fades to a grey "outdated" state rather than pretending everything's fine. Log something to refresh it. (There's an in-app FAQ that answers this and more — tap FAQ on the Stats screen.)

The Carb Tank

The Carb Tank is the simple one: net carbs you've eaten today vs your daily goal, shown as "61 / 50g" with a bar that fills as you log.

  • Under your goal — the bar stays teal and the footer counts down "Xg remaining today".
  • Over your goal — it turns red and tells you how far over you are.
  • Empty — "Log a meal to start filling the tank."

It resets at midnight, your time, and follows whatever carb goal you set in Settings.

The home screen after a high-carb meal, with the Carb Tank at 61 of 50g coloured red and the message 11g over your daily limit, and macro tiles showing fat 45g, protein 43g, fibre 5g, calories 850.
One burger and fries later: the tank turns red at 11g over.

Hidden carbs

The KetoLens party trick

"Keto-friendly" food often isn't. Sauces, dressings, breading, root veg, and anything with sneaky sugar alcohols can carry carbs the label downplays. When the AI spots one of these, it raises a "Possible hidden carbs" flag:

  • On the food item, during analysis and in your diary, as an amber pill.
  • On the Stats screen, totted up under "Carb Intelligence" as "⚠️ X hidden carb warnings this period", with the offending meals listed.

Each warning nudges your battery down a little — they're a real signal, not decoration. Disagree with one? You can dismiss it on the food's edit sheet, and it stops counting against your score.

The Stats screen

Tap Stats in the bottom bar (or View details on the battery) for the full story behind the number. Switch ranges at the top — Today, 7D, and (on Pro) 30D and Custom.

The Stats screen on Today, showing a big score of 10 labelled Rough Estimate, then a Score Breakdown with a Carb Intake card scoring 46/100 and a Fat Ratio card at minus 3 points.
Today's view: the score, then a plain-English breakdown of how it got there.

Today — the score breakdown

The Score Breakdown tells the story as a series of cards: Carb Intake, Fat Ratio, Ketone Override, Consistency, and so on. Each shows its points and a one-line reason — "Your carb intake is moderate at 48g daily-equivalent — under your 50g goal, but getting close." No black box.

The Stats screen on the 7-day range showing a Time in Ketosis card with 1 day in ketosis, current streak 0 days, best streak 5 days, a daily score heatmap, and a Battery Score History chart.
The 7-day view: days in ketosis, streaks, a colour-coded heatmap, and your score history.

7D / 30D — trends & streaks

Pick a longer range and you get the bigger picture: days in ketosis, your current and best streak, a daily score heatmap, and a Battery Score History chart with the ketosis threshold marked.

The Stats screen showing a Net Carb Trend chart averaging 30g per day, and a Week-over-Week comparison of average battery score and days in ketosis.
Net-carb trend and week-over-week comparison.

Net carbs & week-over-week

Below that: a Net Carb Trend line against your keto target, and a Week-over-Week comparison so you can see whether this week beat the last — average score and days in ketosis, with the change called out.

The Stats screen showing a Top Carb Foods list with french fries, brioche bun and dried cranberries, and a Ketone Measurements summary with a ranges legend.
Carb Intelligence: the foods quietly costing you, plus your ketone summary.

Carb Intelligence

Top Carb Foods ranks the items adding the most carbs over the period — useful for spotting a habit. If you log ketones, your readings are summarised here too. The deepest insights (carb thresholds, meal timing, correlations) are a Pro feature.

Next: tired of the AI guessing your go-to foods? Teach it with the Pantry.