Macro Tracking¶

The Home dashboard provides real-time macro tracking with progress bars and goal management.

Overview¶

The macro tracking system provides:

• Daily Progress: Real-time bars for each macro
• Goal Setting: Configurable targets
• Multiple Sources: Meal plan, temp items, inventory consumption
• Historical View: Browse past days

Progress Display¶

The dashboard shows four progress bars:

Visual Indicators¶

• Green Bar: Under goal
• Yellow Bar: Approaching goal (90%+)
• Red Bar: Over goal

Percentage Display¶

Each bar shows:

1500 / 2200 cal (68%)

• Current intake
• Daily goal
• Percentage complete

Setting Goals¶

Configure your targets:

1. Click 🎯 Target Macros on Home
2. Enter values:
3. Carbs (grams)
4. Protein (grams)
5. Fats (grams)
6. Calories calculate automatically

Calorie Formula¶

Calories = (Carbs × 4) + (Protein × 4) + (Fats × 9)

Macro Sources¶

Macros accumulate from multiple sources:

1. Meal Plan Completion¶

When you mark a meal as done:

• Recipe/product macros add to daily total
• Only "done" items count
• Meal prep items don't count until consumed

2. Temp Items¶

Quick-log items not in your inventory:

1. Click "Add Temp Item"
2. Enter name and macros
3. Instantly added to daily total

Use temp items for:

• Restaurant meals
• Snacks at work
• Items without barcodes
• One-off foods

3. Direct Consumption¶

Using Scanner in Consume mode:

• Scan barcode
• Enable "Add to meal plan"
• Macros count toward daily total

Consumed Items List¶

Below the progress bars, see what you've eaten:

Planned vs Consumed¶

The dashboard shows both:

• Consumed: What you've actually eaten (counted)
• Planned: What's scheduled but not marked done

This helps you plan your remaining meals for the day.

Historical View¶

Browse past days:

1. Use date navigation on dashboard
2. See historical consumption
3. Review patterns over time
4. Identify trends

Taste Profile¶

Complement macro tracking with preferences:

1. Click 📝 Taste Profile on Home
2. Enter dietary preferences
3. Note allergies or restrictions
4. Information used for planning assistance

Best Practices¶

1. Log Immediately: Mark meals done right after eating
2. Use Temp Items: Don't skip untracked foods
3. Review Daily: Check progress before dinner
4. Adjust Goals: Update targets as needs change
5. Be Consistent: Track every day for best insights

Integration Points¶