Quick Start Guide

1. Open the App Store on your iPhone.
2. Search for "CaloriSnap" or go directly to: Download CaloriSnap
3. Tap "Get" to install the app.

1. Open CaloriSnap and tap "Create Account".
2. Enter your email address and create a password.
3. Check your inbox and confirm your email by tapping the link you receive.
4. Sign in with your credentials.

On your first login, CaloriSnap will guide you through a quick 4-step setup wizard:

1. Personal data: Enter your age, gender, height, and current weight.
2. Weight goal: Set your target weight and weekly pace (lose, maintain, or gain).
3. Activity & objective: Choose your activity level and primary goal.
4. Your targets: The app calculates your daily calorie budget and macro targets (protein, carbs, fat) based on your profile.

The home screen is your daily command center:

• Calorie Ring: A circular progress indicator showing how many calories you've consumed vs. your daily goal.
• Macro Bars: Individual progress bars for protein, carbs, and fat with your personalized targets.
• Food Diary: All your meals organized by type (Breakfast, Lunch, Dinner, Snack).
• Quick Access: Shortcuts to your favorite features in a 2×2 grid.
• Tab Bar: Navigate between Home, Dashboard, Water, and Profile using the bottom tabs.

1. Tap the "+" floating button and select "Take Photo".
2. Take a clear photo of your food. Make sure the dish is fully visible and well lit.
3. Optionally, tap "Add voice note" to give more context about your meal (useful for specifying quantities or ingredients).
4. The AI will analyze the image and display:
   • Dish name identified
   • Estimated total calories
   • Macronutrients: protein, carbs, fat
   • Additional detail: sugar and fiber
5. Review the results. You can edit any value before saving.
6. Tap "Save Food" to log it, or "Discard" to skip.

Beyond photos, CaloriSnap offers several additional input methods from the "+" menu:

• Scan Recipe: Photograph a written or printed recipe. Set the number of portions the recipe makes and how many you're eating. The AI reads the recipe and calculates per-portion nutrition. Supports multiple pages.
• Dictate Ingredients: Speak or type your ingredients and quantities. The AI analyzes them and calculates the nutrition — no photo needed.
• Scan Barcode: Point your camera at any product barcode for instant nutritional data from the food database.
• Manual Entry: Search your personal food history or the food database. Adjust portions with quick multipliers (½×, ¾×, 1×, 1½×, 2×) or enter custom grams — macros update live. For ingredient-based dishes, tap "Estimate with AI" for an instant AI-powered nutrition estimate. Ideal for homemade meals.

Save time by re-logging meals you eat often:

• Favorite a meal: After saving any food entry, tap the heart icon to add it to your favorites.
• Re-log a favorite: Go to "Favorites" from Quick Access to see all your saved meals and re-log them with one tap.
• Recent meals: Tap "Recent" to see your latest entries and quickly re-log any of them.

Stay hydrated by tracking your daily water consumption:

1. Tap the Water tab in the bottom navigation bar.
2. Use the +250 ml or +500 ml quick-add buttons to log each glass or bottle.
3. Set your personalized daily water goal (default: 2,000 ml).
4. View your weekly hydration chart to see your trends over time.

Track your fasting windows directly in CaloriSnap:

1. From the home screen, tap the Fasting card or access it from Quick Access.
2. Choose a fasting protocol (e.g., 16:8, 18:6, 20:4, or custom).
3. Tap "Start Fast" to begin your fasting timer.
4. The timer shows your elapsed time and progress toward your fasting goal.
5. When you're ready, tap "End Fast" to log the completed session.

Monitor your weight progress and stay on track:

1. Go to "My Goals" on the home screen and tap "Weight Goal".
2. See your progress dashboard with current weight, goal weight, and estimated time to reach it.
3. Tap "Log Weight" to record a new weigh-in.
4. View your weight trend chart to see how your weight has changed over time.

Tap the Dashboard tab to see your complete daily summary:

• Daily Goal card: Shows your calorie budget, consumed calories, and remaining allowance.
• Apple Health data: Steps taken and calories burned (if connected).
• Adjusted remaining: Your calorie goal minus consumed plus burned — giving you a dynamic daily target.
• Water intake progress for the day.
• Meal summary: Total meals, accumulated calories, and average per meal.

Switch between 7, 15, or 30 days to see your trends over time.

Streaks: Log your meals consistently to build a streak. Your current streak is displayed on the home screen. Keep logging daily to earn badges!

iOS Widgets: CaloriSnap offers several widgets for your Home Screen and Lock Screen:

• Calories widget: Shows your daily calorie progress at a glance.
• Water widget: Track hydration without opening the app.
• Streak widget: See your current logging streak.
• Nutritional widget: Macro breakdown in a medium-sized widget.
• Dashboard widget: A large widget with your full daily overview.
• StandBy & Lock Screen: Widgets optimized for StandBy mode and the Lock Screen.
• Apple Watch Complications: Add a CaloriSnap ring to your watch face — Calorie Ring, Water Ring, or Protein Ring. Updates automatically every 15 minutes.

CaloriSnap includes a personal AI nutrition advisor available anytime:

1. From Quick Access, tap "AI Nutrition Advisor".
2. Ask any nutrition question. For example:
   • "What should I eat for breakfast to get more protein?"
   • "Is my diet balanced this week?"
   • "Suggest a low-carb dinner"
3. The AI considers your eating history to give personalized suggestions.

Charts & statistics:

• Calories per day: Line chart showing your daily intake.
• Meal distribution: Pie chart showing the percentage of each meal type.
• Nutritional stats: Full breakdown of protein, carbs, fat, sugar, and fiber with totals and averages.

Export your data — share your nutritional log with your nutritionist or save it:

• CSV: Ideal for Excel or Google Sheets.
• Text: Readable format for email or messaging.
• JSON: Structured format for integrations.

Set up reminders — never forget to log your meals:

1. Go to Notifications from the Profile tab.
2. Enable "Meal Reminders" and set times for Breakfast, Lunch, Dinner, and Snack.

Get personalized meal ideas based on your remaining macros for the day:

1. Tap the "+" floating button and select "Meal Suggestions".
2. The AI analyzes your remaining calories, protein, carbs, and fat for the day.
3. You'll receive 3 personalized meal suggestions tailored to help you meet your daily targets.
4. Each suggestion shows the dish name, estimated calories, and macros.
5. Tap "Log This Meal" to add a suggestion directly to your food diary.

Review your full week of nutrition in one place:

1. Tap "Weekly Report" from the Dashboard tab or from Quick Access on the home screen.
2. See a complete weekly summary:
   • Calorie chart: Bar chart for each day vs. your daily goal.
   • Best & worst day: Identify your strongest and weakest days of the week.
   • Macro consistency: How consistently you hit your protein, carbs, and fat targets.
   • Meal distribution: Breakdown of meals by type across the week.
   • Water & weight: Hydration trend and weight progress.
3. Use the week selector at the top to review previous weeks.

Track your nutrition and log water directly from your wrist:

• Daily summary: See your calorie ring, macro progress, water intake, and streak on your Watch.
• Quick Water Log: Tap any quick-add button (150 / 250 / 350 / 500 ml) to log water from your Watch. Syncs to your iPhone automatically.
• Watch Complications: Add a CaloriSnap ring to your watch face — Calorie Ring, Water Ring, or Protein Ring. Updates every 15 minutes.