The flow agent now has a greatly expanded context window, and builds a profile of you as you use it. The friends tab now updates properly. Serving size bugs have been improved.

Updates to friends tab, glucose insights, flow agent, and more.

Fixed an intermittent issue where the "Process" button on Food Photos would sometimes fail due to a camera timing issue. PDF exports now offer Full Nutrition Averages (daily averages with RDI percentages in a clean table) and Per-Item Nutrition (complete breakdowns per food). Over 70 nutrients now display proper names, unknown IDs are filtered out, water averages only count days with actual data logged, the report shows days tracked, and long text is auto-truncated to prevent overlap.

This update enhances the glucose monitoring features with a new meal prediction view that shows your expected glucose response before eating based on your personal CGM data. Social features have been refined.

Fixed the "missing or insufficient permissions" error when searching for friends by username by updating Firestore security rules to allow authenticated users to search the usernames collection. Usernames now properly persist across app restarts and devices since they're saved to Firebase and reloaded when the app launches. Handles are now locked after your first save so they can't be changed, preventing confusion when friends try to find you. Also fixed an issue where switching accounts could briefly show the previous user's username.

Add Friends now shows a friend requests section at the top so you can always see and manage incoming and sent requests, even when empty. Below that you can search by username or find contacts already on StatsKey. A new sharing and privacy section lets you control what friends see, including a new sleep data toggle. The invite link now goes to the correct App Store page. The circadian clock pulls your actual sleep data from HealthKit and displays it as an indigo arc showing when you were asleep, with moon and sun icons marking bedtime and wake time. A sleep summary card shows your sleep score, duration, and a breakdown of sleep stages. The expanded view shows efficiency and stage percentages so you can see how your sleep affects your daily energy

Version 2.18 introduces features that can be found on the wellness tab for more comprehensive health tracking.

Introducing Friends — a new way to stay motivated with the people you care about. Pro subscribers can now connect with friends through their contacts and share daily progress including meals, macros, activity rings, and workouts. See what your friends are eating with our beautiful meal feed, complete with full nutrition breakdowns and food details. You control exactly what you share with granular privacy settings — share your activity but keep your weight private, or open everything up for full accountability. Tap any friend to dive into their full-screen daily view with detailed meal records, macro summaries, and activity stats. Better together.

In version 2.16, we made My Flow Agent much more reliable—especially after you leave the app and come back—so it keeps working instead of getting stuck. We also fixed a bug where photo-based chats could ignore your selected model; now the app consistently uses your chosen Gemini 3 Flash setting for Flow Agent conversations. Under the hood, we improved the connection to our secure server so responses are more dependable during real-world network changes, along with general stability and performance improvements.

StatsKey 2.15 fixes the Gemini 3 Flash Flow Agent implementation to ensure reliable performance.

StatsKey 2.14 features a simplified subscription model with a 3-day free trial followed by Pro at just $0.99 per month with unlimited meal records, photo scans, and flow access.

Your Flow Agent just got a major upgrade. You can now attach up to five photos at once when chatting with your AI nutrition coach, making it easier to share your fridge contents, meal prep, or food questions all in one message. Photos you send now appear as thumbnails right in your conversation so you can see exactly what you shared. We've also given your Flow Agent better memory. It now has full access to your entire past week of meals organized by day, so when you ask about yesterday's lunch or this week's protein intake, it knows exactly what you're talking about. Your longer-term trends from the past month and beyond are still there for bigger picture questions about your nutrition habits. The AI itself is more natural now. We removed the rigid instructions and let it be a genuine conversation partner that adapts to how you like to talk about food and nutrition. You can also choose between Gemini 3 Flash for quick responses or Gemini 2.5 Pro when you want deeper analysis.

e've made StatsKey simpler and better than ever! We've streamlined our subscription to a single tier at just $2.99 per month with unlimited access to everything. No more confusing pricing tiers or wondering which plan is right for you. For less than a cup of coffee, you get unlimited meal logging, unlimited photo scans, unlimited AI Coach chats, and access to all premium features. We've also completely rebuilt our AI nutrition analysis using Google's lightning-fast Gemini technology, delivering more accurate macros and micronutrients in a fraction of the time. This update introduces powerful new Wellness & Health Insights that help you understand how food affects your body. Track symptoms, mood, energy levels, and sleep, then let StatsKey's intelligent correlation analysis identify patterns and trigger foods you never knew existed. The optional FODMAP tracking helps those with digestive sensitivities discover which foods work best for their body. All wellness tracking is completely optional and privacy-first, with your data staying secure on your device. We've enhanced water tracking with support for your preferred units (ounces, milliliters, cups, or liters) and more accurate daily averages across all time ranges. The improved insights dashboard now shows comprehensive nutrition analysis with better micronutrient tracking and actionable recommendations based on your patterns. We've also fixed numerous bugs including water intake calculations, improved photo analysis accuracy for complex meals, and optimized performance throughout the app. Update now to experience the new StatsKey!

StatsKey 2.11 brings powerful new features to make food recording faster, more accurate, and more flexible than ever. We've introduced two AI analysis modes so you can choose between Ultra Fast for quick recording on the go or Regular mode for thorough analysis of complex meals. Our new multi-input capture system lets you combine multiple data sources in one recording session, including up to 5 photos, barcode scans, nutrition label scans, and text descriptions, giving you complete flexibility in how you track your nutrition. The AI now automatically identifies all food items visible in your photos, making it easier to record meals with multiple components. We've redesigned the food recording interface with a clean, intuitive button layout that adapts perfectly to any screen size, and added a comprehensive guide accessible via the info button that explains all available tools and features. The nutrition label display now shows even more nutrients including B-vitamins, extended minerals, and caffeine when present in your foods. We've added beautiful new visualization components including a circadian clock view for sleep timing insights and metabolic weather displays to help you understand your body's state throughout the day. The customizable dashboard lets you personalize your home screen to focus on the metrics that matter most to you. Library management is now smarter with automatic saving of frequently eaten items and better organization of your saved foods, meals, and supplements. You can now record partial portions of saved items when you don't consume the full serving. We've made significant improvements to AI accuracy and reliability, with enhanced timeout handling and better detection of multiple food items in single photos. The meal composer has been enhanced for easier meal building and editing. Overall, this update delivers a more powerful, flexible, and user-friendly nutrition tracking experience that adapts to your lifestyle.

Version 2.10 represents a major leap forward in accuracy, reliability, and user experience. I've completely overhauled the trial system while fixing critical bugs that were affecting nutrition analysis accuracy. The most visible change is the new trial system. I've replaced the previous 10-free-meal trial with generous 1-month free trials for all subscription tiers. Now users can try Premium, Premium+, or Elite with a full 30 days of unrestricted access at no charge. Free trials are managed directly by Apple through the App Store for better transparency and security. Simply select your preferred tier and tap "Start 1 Month Free Trial" to begin. Your subscription will start automatically after the trial period unless you cancel through your App Store account settings. I've achieved near-perfect accuracy in nutrition analysis, now matching the Gemini app's performance for both Flash and Pro models. The breakthrough was implementing a two-step branded product identification system that explicitly instructs the AI to search for and use official nutrition labels from manufacturers and verified databases. For branded products, the system now searches Google for official label data and uses exact values without estimation. This means products like energy drinks, protein powders, and packaged foods now return nutrition data that exactly matches their official labels. I've also optimized the AI temperature settings to match Gemini's defaults, resulting in more natural and accurate estimations. A critical caffeine tracking bug has been completely resolved. Caffeine was using two different internal IDs across the codebase, causing it to be correctly analyzed but incorrectly displayed in edit screens. I've standardized caffeine to use the correct USDA ID throughout the entire app and enhanced the nutrition label display to show all nutrients Gemini identifies, including B-vitamins, extended minerals, choline, and caffeine. The Flow Agent has received substantial improvements and now properly respects your model selection. Previously, the AI coach was ignoring your chosen model and defaulting to hardcoded selections, meaning Gemini models were never actually being used. I've fixed this disconnect and upgraded to Gemini 2.5 models, which offer a 1-million-token context window compared to GPT's 128K tokens. This means the Flow Agent can now process your entire 30-day nutrition history more effectively and provide faster, more contextually relevant insights. Unit conversion accuracy has been dramatically improved. I fixed a double-scaling bug that was causing nutrients to be scaled twice when switching units, and corrected display issues where quantities weren't updating properly. Now when you convert 170 grams to ounces, the display correctly shows 6.0 ounces with properly scaled nutrition values. Barcode scanning from the photo library has been fixed. Previously, uploaded barcode images weren't being detected due to an orientation issue. I've added automatic orientation correction, so barcoded products from your photo library are now reliably detected and analyzed. I've also implemented comprehensive logging throughout the nutrition analysis pipeline, making it possible to debug any discrepancies by comparing complete request and response data. This transparency ensures I can quickly identify and resolve any future accuracy issues. These improvements represent months of debugging and optimization work, all focused on making

STATSKEY VERSION 2.9 - WHAT'S NEW StatsKey 2.9 brings significant enhancements to AI nutrition analysis with Gemini Pro and Flash models now available for Elite and Premium+ subscribers, delivering near-perfect accuracy that matches Google's Gemini browser results. The app now supports comprehensive tracking of 80+ nutrients including vitamins, minerals, and caffeine with an enhanced nutrition label display that shows all nutrients Gemini identifies. Multi-input scanning has been introduced, allowing users to combine photos, barcodes, and nutrition labels for the most accurate results possible. Water tracking has been significantly improved with customizable units including ml, fl oz, cups, liters, pints, and quarts. The water insights now display actual tracked water intake instead of nutrient data, with accurate averaging across date ranges and unit preferences that sync across devices. Flow Agent capabilities have been dramatically enhanced for Elite users who now receive 3,000,000 monthly tokens compared to the previous 10,000 limit, with response token limits increased to 32,000 tokens and support for extended context windows across all AI models with dynamic token allocation based on subscription tier. Push notification support has been fully enabled with Firebase Cloud Messaging integration and APNS token management for reliable delivery. Critical bug fixes address several long-standing issues starting with meal dates appearing on wrong days due to a timezone conversion bug. Meals are now stored with proper local timezone midnight reference and date filtering uses timezone-aware comparison for accuracy. The app automatically migrates existing meal dates to the correct timezone and improved day rollover detection handles app backgrounding overnight. Nutrition tracking accuracy has been fixed with caffeine now using consistent nutrient ID 1057 throughout the codebase, displaying correctly in all views including the label, edit page, and comprehensive view. Model selection now properly respects user preferences between Pro and Flash models. System stability improvements include fixes for CoachData decoding crashes from legacy Firestore data with graceful backward compatibility for older saved conversations and automatic migration of old data structures. Firebase AppDelegate integration warnings have been resolved and error handling for missing subscription data has been improved. Water insights now display actual tracked water in the user's preferred unit instead of showing grams, with corrected water target calculations and accurate daily averages across all time ranges. Data sync between local storage and Firebase has been improved with better handling of cloud data conflicts, an emergency backup system for meal data protection, and optimized UserDefaults storage to prevent size limit warnings. All fixes have been tested and are production ready with successful builds.

Smart Activity Tracking System (Major New Feature) Version 2.7 introduces a completely redesigned activity tracking system with HealthKit integration. The new Enhanced Activity Tab provides Apple Watch-style activity rings showing Move calories, Exercise minutes, Stand hours, and Steps - all synced directly from HealthKit to match your Apple Health data exactly. The system features intelligent workout deduplication that prevents the same workout from appearing twice if it's synced from multiple sources (like Strava and Apple Watch). It automatically identifies workout sources with color-coded badges and can merge duplicate activities or let you review them manually. Historical averages show your 7-day and 30-day activity trends to help you stay consistent. AI-Powered Nutrition Analysis Improvements The Gemini integration now achieves near-perfect accuracy matching Google's browser results. A critical caffeine tracking bug was fixed where caffeine values were being lost between analysis and display. The system now supports GPT-5, Gemini 2.5 Pro, and Grok-4 with proper context window management. Elite tier users get 3 million monthly tokens with 32,000-token responses for complex meal analysis. Enhanced Wellness Tracking New opt-in wellness features include GI health monitoring with FODMAP tracking, Bristol Stool Chart logging, and trigger food identification. Mental health tracking captures mood, energy levels, and stress with correlation analysis against nutrition. The supplement and medication diary helps track how vitamins and medications affect your health metrics. Improved User Experience Water tracking now displays in your preferred unit (ml, oz, cups, L) with accurate daily averages. The nutrition label view dynamically shows all nutrients found by AI including B-vitamins, extended minerals, and caffeine. Profile settings now include biological sex profiles with hormone-aware BMR calculations for accurate calorie targets. ##Critical Bug Fixes Fixed unit conversion crashes for HealthKit stand hours, resolved HealthKit authorization issues that prevented activity data from loading, and eliminated caffeine data loss in the edit interface. The app now handles missing fields gracefully when loading old data from Firebase.

Version 2.6 brings significant improvements to the nutrition tracking app since version 2.4, with the most notable enhancement being intelligent multi-item food detection. When you take a photo of a plate with multiple food items like steak and potatoes, the system now identifies each item separately using Gemini 2.5's advanced vision capabilities, providing comprehensive nutrition data with 15-40 nutrients for each individual item along with estimated serving sizes based on visual analysis. This replaces the previous behavior that would just return a generic "food image" label. The app has also been upgraded to use only Gemini 2.5 models, specifically Gemini 2.5 Flash and Gemini 2.5 Pro, with all fallbacks to older 1.5 and 2.0 versions completely removed. This ensures consistent best-in-class performance across all nutrition analysis features, delivering 5-10x faster response times with the Flash model while maintaining exceptional accuracy. The Gemini 2.5 Pro model is available for Premium Plus and Elite subscribers who want maximum accuracy for complex meals. A new upload image option has been added to the "Add Food Item" screen when editing meals, allowing you to select existing photos from your library rather than only taking new camera photos. This is particularly useful for uploading restaurant menu photos, meal prep images, or retroactively logging meals from photos you already have. The uploaded images are automatically analyzed using the same multi-item detection and comprehensive nutrient analysis as camera photos. The subscription purchase experience has been completely redesigned with a one-tap purchase system that follows Apple StoreKit 2 best practices. Instead of the previous two-step flow where you selected a plan and then tapped subscribe, each subscription tier now displays direct "Subscribe Now" buttons for both monthly and annual options, reducing the friction from multiple taps to just one and leading to higher conversion rates while maintaining full security through Apple's native payment system. The Flow Agent has been fixed to actually use the AI model you select in the interface, correcting a critical bug where the UI selection was completely ignored and a hardcoded model was used instead. Elite tier users now receive 3 million tokens per month instead of the previous 10,000 token limit, with support for 32,000 token responses and proper integration with large context models like GPT-5 and Gemini 2.5 Pro that have context windows up to 1 million tokens. Water tracking insights have been corrected to display actual tracked water consumption in your preferred units like milliliters, fluid ounces, cups, or liters, rather than incorrectly showing water from nutrient data in grams. The settings now include a water unit picker allowing you to customize how water intake is displayed throughout the app. Firebase and push notifications are now properly configured with a new AppDelegate implementation that handles Firebase Messaging, APNS token management, and the required aps-environment entitlement. The app also includes backward compatibility fixes for older Firestore data that previously caused crashes with missing fields like macroTargets or subscriptionTier, now gracefully handling legacy data with automatic migration to the new structure. Additional improvements include comprehensive debug logging throughout the nutrition analysis pipeline to track data transformations, validation warnings for suspicious nutrition values, and fixes ensuring accurate per-serving versus per-100g nutrient interpretation. All these updates are production-ready with successful builds and no linting errors.

Version 2.5 introduces an AI-powered serving size estimation feature that helps users get more accurate portion sizes for their food logging. The core addition is a new estimation sheet that uses the Gemini API to intelligently suggest realistic serving sizes for any food item. When you tap the sparkles button that now appears throughout the app, it analyzes the food description and provides serving suggestions with confidence levels, alternate portion options, and a live preview of how the nutrition values will change. The estimation button has been added to multiple places so it's available wherever you edit food. You'll find it in the review and edit screens when logging new food, in the comprehensive food editor, when editing individual items in saved meals, and even in the quick inline editor that appears in meal lists. All these buttons work alongside the existing manual controls like the times-two and divide-by-two buttons, unit converters, and text fields, so you can use AI to get started and then fine-tune manually if needed. For editing entire meals at once, there's now a bulk estimation feature accessible from the menu when editing meals with multiple items. It processes each food item sequentially, showing a progress overlay with which item it's currently estimating, and you can cancel at any time to restore the original values. The system includes rate limiting with half-second delays between items to avoid overwhelming the API. The feature respects your subscription tier, using Gemini Flash for most users and offering Pro for Elite tier subscribers based on their speed preference setting. All nutrition scaling happens automatically when you apply a suggested serving size, maintaining the proportional relationships between calories, protein, carbs, fat, and all other tracked nutrients. The implementation integrates seamlessly with existing serving size editing functionality without replacing or hiding any manual controls.

Version 2.3 introduces a comprehensive health evaluation system powered by Gemini AI that analyzes any food product and provides factual evidence-based insights without arbitrary scores, displaying health benefits, considerations, complete ingredient lists with notable ingredients highlighted and explained inline, food additives with neutral descriptions, and processing level categorization from whole foods to ultra-processed items in a clean Apple-style interface. A new Food Health Scanner in the My Flow tab allows users to search, scan barcodes, or photograph any product for instant health analysis with a history of recent scans. The Review and Edit screen now includes collapsible health insights that don't interfere with the primary editing workflow. Nutrition data accuracy has been significantly improved by fixing serving size interpretation issues where values were sometimes displaying at half the correct amounts, now with proper nutrient basis field handling and comprehensive validation throughout the data pipeline. The Flow Agent has been completely overhauled to respect user-selected AI models instead of ignoring them in favor of hardcoded defaults, updated to Gemini 2.5 models replacing outdated 1.5 versions, Elite tier users now receive 3 million monthly tokens with 32,000 token responses, and fixed Firestore paths ensuring subscription tiers are read correctly. Water tracking improvements include proper swipe-to-delete functionality using List views instead of ScrollView, accurate intake calculations displaying in user-preferred units whether metric or imperial, and correct average calculations across date ranges. The subscription purchase flow has been streamlined to one-tap purchasing where each tier displays direct monthly and annual buttons that immediately launch Apple's native StoreKit 2 payment sheet with biometric authentication, reducing friction and providing clearer pricing visibility while maintaining full App Store compliance. Additional improvements include backward-compatible CoachData decoding with graceful error handling for legacy data, proper Firebase integration with AppDelegate implementation for push notifications, enhanced debug logging throughout the nutrition data pipeline for troubleshooting, and comprehensive error messaging guiding users through setup issues. All features maintain backward compatibility ensuring seamless upgrades without data loss, with the new optional healthInsights property added to food items for persistence and cloud sync, proper nil handling throughout for users without health data, and graceful degradation when services are unavailable.

Your personal AI nutrition coach called Flow Agent is now live and it's absolutely game-changing with support for the latest AI models including GPT-5, Gemini 2.5 Pro and Flash, and Grok-4 that can analyze your entire 30-day nutrition history and give you personalized recommendations based on everything you've eaten, your symptoms, mood, and energy levels all working together to understand your unique nutritional needs. We've added comprehensive GI Health tracking for anyone dealing with digestive issues including detailed symptom tracking, Bristol Stool Chart integration, FODMAP food classification with a complete guide to high and low FODMAP foods, trigger food identification that uses AI to find patterns between what you eat and how you feel, and elimination diet program support. The new Wellness Journal lets you track mood, energy levels, sleep quality, and physical symptoms alongside your nutrition data so you can see how everything connects, and our correlation analysis engine automatically identifies patterns like how certain foods affect your energy or which meals correlate with digestive symptoms. Supplement and medication tracking is now built in with support for vitamins, minerals, prescriptions, and over-the-counter medications complete with dosage tracking and nutrition label scanning for supplement facts. AI-powered food recognition got massively upgraded with Gemini vision that can analyze any photo of food and return accurate nutrition data including calories, macros, and micronutrients with support for both packaged foods with labels and prepared meals. Enhanced nutrition insights now show you detailed breakdowns of 30+ micronutrients, personalized recommendations based on your deficiencies, beautiful charts showing nutrient trends over time, and comparisons against your daily targets. Water tracking got completely overhauled with support for your preferred units including milliliters, fluid ounces, cups, liters, pints, and quarts plus accurate daily averages and goal tracking that actually uses your tracked water instead of food nutrient data. HealthKit integration is now automatic and bidirectional syncing your nutrition data to Apple Health, importing weight entries and exercise data, and keeping everything synchronized in the background without you lifting a finger. The user library system now lets you save your frequently eaten foods and favorite meals with favorites marking, quick search, and intelligent sorting by most used. Cloud sync with Firebase keeps all your data secure and synchronized across devices with real-time updates, automatic backup and recovery, and conflict resolution that protects your data. We fixed critical bugs where Elite users were incorrectly limited to 10,000 tokens instead of 3 million monthly tokens, the AI model selector now actually uses the model you select instead of ignoring your choice, Gemini image analysis was showing half the correct calorie values due to a nutrient basis calculation error, water insights were displaying nutrient data instead of actual tracked water, and the app would crash when loading old conversation data with missing fields. Performance improvements include 5-10x faster AI responses when using Gemini Flash, better context understanding with expanded token windows up to 2 million tokens for Gemini, more accurate nutrition data with comprehensive logging and validation, and improved data protection with multiple backup layers and emergency recovery systems.

Optional wellness tracking (privacy‑first): Turn on advanced logging for symptoms, mood, energy, sleep, and GI health. Discover correlations between foods, lifestyle, and how you feel to uncover potential triggers—complete with energy and mood records, and GI tools like FODMAP guidance and Bristol Stool Chart tracking. Everything is 100% opt‑in with clear consent and can be turned off anytime. Smarter nutrition scanning: AI food recognition now returns correct per‑serving values with improved consistency and validation for suspicious entries, so your nutrition details better reflect reality. Move & Activity are now exact: Move calories match Apple Health using the same method the Health app uses, with more reliable, faster syncing and clearer fallbacks when Apple’s summary isn’t available. Workout history is cleaner too—manually logged, Apple Watch, and Strava workouts now appear once (no duplicates). Stand Hours are clarified and accurate: We use Apple Health’s definition (you earn a stand hour by standing and moving for at least 1 minute in that hour). An in‑app info note explains the metric and why it may show 0 if your device doesn’t provide stand data. Plus performance, reliability, and compatibility updates: faster syncs, stronger data integrity, improved error handling, iOS 18 compatibility, and a host of bug fixes to keep everything smooth and responsive.

Fixed an issue where recent food and meal items were not displaying in the Review & Edit screen's library browser.

Daily average macronutrients now correctly exclude today by default; the include-today toggle is respected on initial load, time range changes, and refresh. Activity/move averages (7-day and 30-day) now exclude today; the weekly activity summary also excludes today from averages. Calculations are now consistent across views, using complete days only for more accurate averages.

Lightning-Fast Food Analysis We've upgraded our Gemini AI pulls, making food recognition 4-8x faster. You'll now get comprehensive nutrition breakdowns (15-40+ nutrients) in just 3-6 seconds instead of waiting 10-15 seconds. We've also improved accuracy for packaged foods and mixed meals. AI Adaptive Calorie Targeting - New! This game-changing feature learns YOUR actual metabolism using data from Apple Health. Instead of generic calculators, the app now calibrates your BMR using 30 days of your real basal energy data, then adds your actual daily activity for personalized targets that adapt with you. You can see your 7-day and 30-day patterns to better understand your trends. Note: Works best with Apple Watch or similar fitness devices for accurate measurements. Better Activity Tracking We've completely overhauled energy balance calculations to show your true calorie deficit or surplus. Fixed issues with steps not appearing, improved exercise minute tracking, and eliminated double-counting of HealthKit data so your move ring is now perfectly accurate. Smarter Weight Goals Your weight goals now stay in sync across the entire app. When you adjust your goal, you'll see exactly how it impacts your calorie targets in real-time, with calculations that account for your AI Adaptive metabolism (not just generic formulas). Performance & Reliability Fixed camera freezing when taking food photos, eliminated app slowdowns during startup, and resolved various bugs that were affecting the barcode scanner and data syncing. Cleaner Interface Your energy balance now shows at a glance whether you're in a deficit or surplus with color-coded indicators. Historical activity patterns are easier to read, and calorie targets are consistent everywhere you look.