Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
86 changes: 86 additions & 0 deletions Projects/2-Intermediate/Calorie-Count-App.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
# App Idea: Calorie Count App

**Tier:** 2 - Intermediate

---

## Description

The **Calorie Count App** allows users to calculate the total **calorie count** and other nutritional values (like **protein** and **natural sugar**) of a custom meal by selecting ingredients and quantities.

For example, if a user creates a **pizza** with ingredients such as *dough, mayo, sauce, carrot, onions, cheese*, the app will display the total calorie, protein, and sugar count for the entire meal.

---

## Purpose of the Application

The purpose of this app is to help users:
- Track their calorie intake based on custom recipes or meals.
- Make healthier food choices by understanding nutritional breakdowns.
- Simplify fitness and diet tracking through ingredient-based analysis.

---

## Resources Needed

- **Food Nutrition Database/API** (e.g., Edamam Food Database API, Nutritionix API)
- **Frontend framework** (React / Vue / Flutter for mobile)
- **Backend service** (Node.js / Firebase / Django)
- Optional: **Authentication service** (Firebase Auth or Auth0)

---

## User Stories

- User can **input ingredients** manually or select them from a predefined list.
- User can **enter the quantity** (in grams, cups, or servings) for each ingredient.
- User can **view total calorie count** for the entire meal.
- User can **view macronutrient breakdown** (protein, fat, carbs, sugar).
- User can **save meals** for future reference.
- User can **edit or remove ingredients** from a meal before calculating.

---

## Bonus Features

- User can **scan barcodes** of packaged foods to automatically fetch nutrition data.
- User can **log daily meals** and track total calories per day.
- User can **set dietary goals** (e.g., calorie limit, protein target).
- User can **generate reports or insights** on weekly eating patterns.
- User can **share meals** with friends or nutrition coaches.

---

## Useful Links and Resources

- Edamam Food Database API Documentation
- Nutritionix API
- USDA FoodData Central
- React Documentation
- Firebase Documentation

---

## Example Projects

- Calorie Counter projects on GitHub (search term: "calorie counter app")
- MyFitnessPal — popular calorie and nutrition tracking app.

---

**Note:** This idea is distinct from the existing *Calorie Counter (Tier 3 – Advanced)* project in the repo.
The existing idea focuses on transforming and searching a raw dataset (USDA MyPyramid) and optimizing large-dataset search.
This *Calorie Count App* focuses on **ingredient-level meal construction** and **real-time aggregated nutrition** (user-oriented, not a dataset transformation challenge).


"""Module placeholder for Calorie Count App documentation.

This module exists to provide docstring coverage for the project
submission describing the Calorie Count App idea.
"""

def calorie_app_description():
"""Describe the purpose and functionality of the Calorie Count App."""
return (
"The Calorie Count App allows users to create meals from ingredients "
"and view total calories, proteins, and sugars." )