Recipes¶
The Recipes page is your cookbook with intelligent filtering by macro density and ingredient availability.
Overview¶
The recipe system provides:
- Recipe Database: Store all your recipes with ingredients
- Macro Calculations: Auto-computed nutrition per serving
- Density Filters: Find high-protein or low-carb options
- Availability Filter: Show only recipes you can make now
- Meal Plan Integration: Add recipes directly to calendar
Recipe Cards¶
Each recipe displays:
| Field | Description |
|---|---|
| Name | Recipe title |
| Servings | Number of portions |
| Per Serving | Calories and macros per portion |
| Total | Full recipe nutrition |
| Active Time | Hands-on cooking time |
| Total Time | Including passive time |
| Density Percentiles | Protein/carb rankings |
Creating Recipes¶
Basic Info¶
- Click "New Recipe"
- Enter name and description
- Set servings count
- Add active and total time
Adding Ingredients¶
- Click "Add Ingredient"
- Select product from your catalog
- Enter amount and unit
- Repeat for all ingredients
Automatic Macro Calculation¶
As you add ingredients:
- Calories sum automatically
- Protein, carbs, fats calculated
- Per-serving values computed
- Density percentiles update
Filtering Recipes¶
Can Be Made Filter¶
Shows only recipes you have ingredients for:
- Enable "Can Be Made" toggle
- System checks current inventory
- Only cookable recipes display
- Great for deciding what to cook tonight
Protein Density Slider¶
Filter by protein efficiency:
- Measures grams of protein per 100 calories
- Higher = more protein-efficient
- Slider sets minimum threshold
- Example: 10+ g/100 cal filters to high-protein
Carb Density Slider¶
Filter by carb content:
- Measures grams of carbs per 100 calories
- Lower = better for low-carb diets
- Slider sets maximum threshold
- Example: under 15 g/100 cal for keto-friendly
Time Filters¶
Limit by prep time:
- Active Time Max: Hands-on minutes
- Total Time Max: Including passive cooking
Density Percentiles¶
Each recipe shows percentile rankings:
This means:
- Protein density beats 85% of your recipes
- Carb density is lower than 77% of recipes
Finding Optimal Recipes
Sort by protein percentile to find your most protein-efficient meals. Great for hitting protein goals without excess calories.
Recipe Execution¶
When you cook a recipe:
Regular Cooking¶
- Add recipe to meal plan
- Mark as done when eaten
- Ingredients deducted from inventory
- Macros added to daily total
Meal Prep Mode¶
- Add recipe to meal plan as "Meal Prep"
- Click "Execute" to batch cook
- Ingredients deducted
- [MEAL] products created for each serving
- Consume [MEAL] products later
Best Practices¶
- Complete Ingredients: Add all ingredients for accurate macros
- Use Gram Weights: Most accurate for nutrition
- Update Regularly: Keep recipes current with your cooking style
- Review Percentiles: Use density metrics to optimize meals
- Set Accurate Times: Helps with meal planning
Integration Points¶
| Feature | Integration |
|---|---|
| Products | Ingredients sourced from product catalog |
| Inventory | "Can Be Made" checks stock levels |
| Meal Plan | Add recipes to calendar |
| Macros | Recipe macros flow to tracking |
| Shopping | Recipe ingredients added to shopping list |