Question 1

How does AI meal logging work in CalStory?

Accepted Answer

Tap “Log with AI” and describe what you ate in plain language — for example, “two eggs, toast, and a protein shake.” The model returns a structured calorie and macro breakdown (calories, protein, carbs, fat, serving size) in 6–9 seconds. Every AI suggestion opens a review screen where you can edit any field before saving. The model also remembers your recent meals for one-tap re-logging. CalStory uses Google Gemini under the hood, with an optional personal API key in Settings to bypass shared quota.

Question 2

How does CalStory calculate my TDEE?

Accepted Answer

CalStory uses the Mifflin-St Jeor equation as the starting point (10 × weight(kg) + 6.25 × height(cm) − 5 × age + 5 for men or −161 for women), which is the most accurate of the standard formulas for most adults. The result is your BMR, which is then multiplied by an activity factor between 1.4 and 1.75 based on weekly workouts, daily step count, and job activity to give TDEE. CalStory also auto-tunes your calorie target in 50 kcal increments based on your 7-day weight trend from the Progress page — the same calibration approach MacroFactor uses.

Question 3

What does the streak counter track?

Accepted Answer

Your streak counts consecutive days where you have logged at least one meal. A day only counts if the meal was saved on that calendar day, not backdated. Skipping one day does not reset the streak; missing two consecutive days does. The Progress page’s 16-week consistency heatmap is the more useful stat — it surfaces patterns you would never notice otherwise, like “I always skip Thursdays.”

Question 4

Is my CalStory data stored securely?

Accepted Answer

Yes. CalStory is open source and every line of the app and API is on GitHub. There is no CalStory-controlled server that touches your data. When you sign in, your data is read from and written to your own Firebase project (or your self-hosted Postgres). Your meals, workouts, weight, and profile are stored under users/{uid}/... paths with Firestore security rules that restrict reads and writes to the authenticated user. The only network calls your browser makes are to Firebase and to Google’s Gemini endpoint. We do not run analytics, ad pixels, or third-party tracking.

Question 5

Is CalStory free?

Accepted Answer

Yes — every feature is free with no usage caps on the core flow and no premium tier. The only feature with a soft limit is AI food logging: the shared Gemini quota covers roughly 30–50 AI logs per day, and a personal Gemini API key in Settings bypasses it entirely with usage billed directly to your Google account. The repo is open source under a permissive license, so you can self-host the entire stack on Vercel + Firebase Spark plan for free.

Your calorie
story.

Get fit with AI-powered tracking.

Zero Friction. Maximum Results.

Log meals in seconds with AI

Hit your macros without spreadsheets

Track every set, every workout

See real progress, not just numbers

Built for lifters, runners, and everyone in between

Frequently Asked Questions

Ready to hit your
absolute peak?

Your calorie story.