Skip to content

Latest commit

Β 

History

History
1186 lines (908 loc) Β· 29.8 KB

File metadata and controls

1186 lines (908 loc) Β· 29.8 KB

🍳 Recipe Integration User Guide

Version: 1.0 Last Updated: October 2025 Feature: Phase 26 - Recipe Integration

Welcome to the Recipe Integration guide! This comprehensive guide will help you master recipe management, meal planning, and shopping list generation in the Grocery List app.

πŸ“‹ Table of Contents

  1. Getting Started
  2. Creating Your First Recipe
  3. Managing Ingredients
  4. Meal Planning Tutorial
  5. Generating Shopping Lists
  6. Recipe Collections
  7. Sharing Recipes
  8. Import/Export Recipes
  9. Tips & Best Practices
  10. Troubleshooting
  11. FAQ

πŸš€ Getting Started

What is Recipe Integration?

Recipe Integration transforms your Grocery List app into a complete meal planning solution. You can:

  • Create & Store Recipes - Save all your favorite recipes in one place
  • Plan Your Meals - Schedule recipes for specific days and meal times
  • Generate Shopping Lists - Automatically create grocery lists from your meal plans
  • Organize Collections - Group related recipes into collections
  • Share Recipes - Make recipes public for others to discover

Prerequisites

Before you begin:

  • βœ… You must have an account (Sign up if you haven't)
  • βœ… You must be logged in
  • βœ… You should have at least one grocery list created
  • βœ… Basic familiarity with the grocery list features

Accessing Recipe Features

  1. From the Main Menu:

    • Click on the hamburger menu (☰) in the top-left
    • Select "Recipes" to manage your recipes
    • Select "Meal Planner" to plan your meals
    • Select "Collections" to organize recipes
  2. From Keyboard Shortcuts:

    • Press R to open recipes
    • Press M to open meal planner
    • Press C to open collections

🎨 Creating Your First Recipe

Step 1: Open the Recipe Creator

  1. Navigate to the Recipes page
  2. Click the "+ New Recipe" button in the top-right
  3. The recipe editor will appear

Step 2: Fill in Basic Information

Recipe Title (Required)

  • Enter a descriptive name for your recipe
  • Examples: "Mom's Famous Lasagna", "Quick Chicken Stir-Fry"
  • Maximum 255 characters

Description (Optional)

  • Brief description of the dish
  • What makes this recipe special?
  • Examples: "A family favorite for Sunday dinners", "Perfect for busy weeknights"

Instructions (Optional but recommended)

  • Step-by-step cooking instructions
  • Use numbered steps for clarity
  • Example:
    1. Preheat oven to 375Β°F
    2. Mix dry ingredients in large bowl
    3. Add wet ingredients and stir until combined
    4. Pour into greased pan
    5. Bake for 25-30 minutes
    

Step 3: Add Cooking Details

Prep Time (Optional)

  • Time needed to prepare ingredients
  • Enter in minutes
  • Example: 15 (minutes)

Cook Time (Optional)

  • Time needed to cook the dish
  • Enter in minutes
  • Example: 30 (minutes)

Servings (Optional, default: 4)

  • Number of servings the recipe makes
  • Used for shopping list calculations
  • Example: 6

Difficulty (Optional)

  • Choose: Easy, Medium, or Hard
  • Helps you quickly identify simple recipes
  • Example: Easy

Cuisine Type (Optional)

  • Type of cuisine (Italian, Mexican, Asian, etc.)
  • Used for filtering recipes
  • Example: Italian

Image URL (Optional)

Step 4: Add Ingredients

  1. Click "+ Add Ingredient" button

  2. Fill in the ingredient details:

    • Name (Required): Ingredient name (e.g., "Flour")
    • Quantity (Optional): Amount needed (e.g., "2")
    • Unit (Optional): Unit of measurement (e.g., "cups")
    • Category (Optional): Grocery category for list organization
    • Notes (Optional): Preparation notes (e.g., "finely chopped")
  3. Click "Add" to add the ingredient

  4. Repeat for all ingredients

Example Ingredients:

- 2 cups Flour (Pantry) - sifted
- 3 whole Eggs (Dairy) - room temperature
- 1 lb Ground Beef (Meat) - 80/20 blend
- 1 can Tomato Sauce (Pantry) - 15 oz

Step 5: Organize Ingredients

Reorder Ingredients:

  • Drag and drop ingredients to reorder them
  • Or use the ↑↓ buttons to move items
  • Order matters for recipe clarity!

Edit Ingredients:

  • Click the ✏️ (edit) button next to any ingredient
  • Modify any field
  • Click "Save" to confirm changes

Delete Ingredients:

  • Click the πŸ—‘οΈ (trash) button next to any ingredient
  • Confirm deletion in the dialog

Step 6: Set Visibility

Private Recipe (Default)

  • Only you can see and use this recipe
  • Safe for personal recipes

Public Recipe

  • Other users can discover and use your recipe
  • Your name will appear as the author
  • You can change this setting anytime

Step 7: Save Your Recipe

  1. Review all information
  2. Click "Save Recipe" button
  3. Your recipe is now saved!
  4. You'll be returned to the recipe list

Quick Recipe Creation Tips

πŸ’‘ Start Simple

  • Don't worry about perfection on your first try
  • You can always edit recipes later
  • Start with your most-used recipes

πŸ’‘ Use Clear Names

  • Make titles searchable ("Easy Pasta" vs "Pasta")
  • Include key ingredients if helpful ("Chicken Pasta with Pesto")

πŸ’‘ Be Specific with Instructions

  • Include temperatures, times, and techniques
  • Break complex steps into smaller steps
  • Add cooking tips or variations

πŸ’‘ Organize Ingredients by Usage

  • Group ingredients by when they're used
  • List them in order of use
  • Separate wet and dry ingredients if baking

πŸ₯• Managing Ingredients

Understanding Ingredients

Each ingredient in your recipe has several properties:

Name - What the ingredient is

  • Required field
  • Be specific: "All-purpose flour" vs "Flour"
  • Use consistent naming for better shopping lists

Quantity - How much you need

  • Optional but recommended
  • Use numbers: 2, 1.5, 0.5
  • Can be fractional

Unit - Unit of measurement

  • Optional but recommended
  • Common units: cups, tbsp, tsp, oz, lb, g, kg
  • Use standard abbreviations

Category - Grocery category

  • Optional but very helpful
  • Used to organize shopping lists
  • Options: Produce, Dairy, Meat, Bakery, Pantry, Frozen, Beverages, Other
  • Auto-maps to your grocery list categories

Notes - Preparation instructions

  • Optional but can be very useful
  • Examples: "finely chopped", "room temperature", "diced"
  • Include important details like "15 oz can"

Adding Ingredients Efficiently

Method 1: One at a Time

  1. Click "+ Add Ingredient"
  2. Fill in details
  3. Click "Add"
  4. Repeat

Method 2: Bulk Entry (Coming Soon)

  • Paste ingredient list from clipboard
  • AI parsing of quantities and units
  • Quick import from other recipes

Editing Ingredients

Edit Individual Ingredient:

  1. Find the ingredient in the list
  2. Click the ✏️ (edit) icon
  3. Modify any field
  4. Click "Save Changes"

Edit Multiple Ingredients:

  1. Edit recipe (click "Edit Recipe" button)
  2. Make changes to multiple ingredients
  3. Save the entire recipe

Ingredient Best Practices

βœ… Be Specific

Good: "2 cups all-purpose flour, sifted"
Bad:  "Flour"

βœ… Include Brand When Important

Good: "1 cup Heinz ketchup (or to taste)"
Bad:  "Ketchup"

βœ… Specify Size for Cans/Packages

Good: "1 can (15 oz) black beans, drained"
Bad:  "1 can black beans"

βœ… Add Prep Instructions in Notes

Good: Name: "Onion", Notes: "finely diced"
Good: Name: "Chicken breast", Notes: "cut into 1-inch cubes"

βœ… Use Consistent Units

Good: All volume in cups (1 cup, 0.5 cup, 0.25 cup)
Bad:  Mix of units (1 cup, 4 oz, 2 tbsp) - harder to scale

πŸ“… Meal Planning Tutorial

Understanding Meal Planning

Meal planning helps you:

  • πŸ“‹ Organize meals for the week
  • πŸ›’ Generate shopping lists automatically
  • πŸ’° Reduce food waste and save money
  • ⏰ Save time during busy weekdays

The Meal Planner Interface

The meal planner shows:

  • Calendar View: 7-day week view
  • 4 Meal Slots per Day: Breakfast, Lunch, Dinner, Snack
  • Week Navigation: Previous/Next week buttons
  • Current Date Indicator: Today is highlighted
  • Quick Actions: Add, edit, delete meals

Adding a Meal to Your Plan

Method 1: Click to Add

  1. Navigate to the Meal Planner page
  2. Find the date and meal type (e.g., Monday Dinner)
  3. Click the empty meal slot (or "+ Add Recipe" button)
  4. Select a recipe from the dialog
  5. Confirm the addition

Method 2: Drag and Drop (Coming Soon)

  1. Open recipe list sidebar
  2. Drag recipe to meal slot
  3. Drop to assign

Meal Slot Details

Each meal slot shows:

  • Recipe Name: Quick identification
  • Recipe Image: Visual preview
  • Cooking Time: Total prep + cook time
  • Servings: Number of servings
  • Cooked Status: Checkbox to mark as cooked

Editing a Meal Plan

  1. Click on the meal slot
  2. Click "Edit" from the action menu
  3. Modify:
    • Date: Change to different day
    • Meal Type: Change breakfast to lunch, etc.
    • Servings: Adjust serving count
    • Notes: Add special notes
  4. Click "Save Changes"

Marking Meals as Cooked

Why mark meals as cooked?

  • Track which meals you've completed
  • Skip cooked meals when generating shopping lists
  • See your cooking progress for the week

How to mark as cooked:

  1. Find the meal on the planner
  2. Check the "Cooked" checkbox
  3. Or click meal β†’ "Mark as Cooked" from menu

Deleting Meal Plans

  1. Click on the meal slot
  2. Click "Delete" from the action menu
  3. Confirm deletion
  4. The slot returns to empty state

Week Navigation

View Different Weeks:

  • Click "β—€ Previous Week" to go back
  • Click "Next Week β–Ά" to go forward
  • Use keyboard: ← (previous), β†’ (next)

Return to Current Week:

  • Click "Today" button
  • Keyboard: Press T

Planning Tips

πŸ’‘ Plan on Sundays

  • Review your calendar for the week
  • Consider busy days (plan quick meals)
  • Balance variety and nutrition

πŸ’‘ Reuse Favorites

  • Don't reinvent the wheel
  • Rotate favorite recipes
  • Build a standard rotation

πŸ’‘ Batch Similar Meals

  • Plan multiple pasta dishes in one week
  • Buy in bulk and save money
  • Prep multiple recipes at once

πŸ’‘ Consider Leftovers

  • Plan larger recipes on Sunday
  • Use leftovers for Monday lunch
  • Factor into serving sizes

πŸ’‘ Balance Cooking Times

  • Mix quick meals (15 min) with longer meals
  • Save elaborate recipes for weekends
  • Keep weeknight dinners simple

πŸ›’ Generating Shopping Lists

What is Shopping List Generation?

Automatically create grocery lists from your meal plans:

  • βœ… All ingredients from planned meals
  • βœ… Organized by category
  • βœ… Quantities combined intelligently
  • βœ… Skip meals already cooked
  • βœ… Add directly to your grocery list

How to Generate a Shopping List

Step 1: Plan Your Meals

  • Add recipes to your meal planner
  • Choose a date range (e.g., Monday-Sunday)
  • Ensure meals are not marked as cooked

Step 2: Open List Generator

  1. Go to Meal Planner page
  2. Click "Generate Shopping List" button
  3. The generator dialog opens

Step 3: Select Date Range

  1. Choose Start Date (e.g., Oct 28, 2025)
  2. Choose End Date (e.g., Nov 3, 2025)
  3. Usually select Monday - Sunday for weekly shopping

Step 4: Choose Destination

Option A: Preview Only

  • Don't select a grocery list
  • Click "Generate"
  • Review ingredient list
  • Copy to clipboard or screenshot
  • Manually add to list later

Option B: Add to Existing List

  • Select a grocery list from dropdown
  • Click "Generate & Add to List"
  • Ingredients automatically added
  • Opens the selected list

Option C: Create New List

  • Click "Create New List"
  • Name the list (e.g., "Weekly Groceries Oct 28")
  • Ingredients added to new list
  • Opens the new list

Understanding the Generated List

Ingredient Aggregation: The system combines duplicate ingredients:

Recipe 1: 2 cups flour
Recipe 2: 1 cup flour
Generated: 3 cups flour (2 + 1)

Category Organization: Ingredients grouped by category:

Produce:
  - 3 apples
  - 1 lb carrots

Dairy:
  - 2 cups milk
  - 8 oz cheddar cheese

Pantry:
  - 3 cups flour
  - 2 tbsp olive oil

Notes Included: Preparation notes are preserved:

- 1 lb chicken breast (cut into 1-inch cubes)
- 1 onion (finely diced)

Meal Source Tracking: Each item notes which meals it's from:

Notes: "From meal plans (Oct 28 - Nov 3)"

Shopping List Generation Tips

πŸ’‘ Check Your Pantry First

  • Review generated list before shopping
  • Remove items you already have
  • Adjust quantities as needed

πŸ’‘ Generate Mid-Week Too

  • Don't just shop on Sunday
  • Generate for remaining days
  • Pick up fresh ingredients mid-week

πŸ’‘ Adjust Serving Sizes

  • Edit meal servings before generating
  • Scale up for leftovers
  • Scale down for fewer people

πŸ’‘ Review Before Shopping

  • Check for duplicate items
  • Combine similar items (e.g., all tomatoes)
  • Look for opportunities to buy in bulk

πŸ’‘ Mark Items as Gotten

  • Use the shopping list check-off feature
  • Track what you've picked up
  • Don't buy things twice

πŸ“š Recipe Collections

What are Recipe Collections?

Collections help you organize recipes into groups:

  • πŸ“ Meal Type: Breakfasts, Lunches, Dinners, Snacks
  • πŸŽ‰ Occasion: Party Food, Holiday Meals, Weeknight Dinners
  • 🌍 Cuisine: Italian, Mexican, Asian, Mediterranean
  • πŸ‘₯ Audience: Kids' Favorites, Date Night, Family Dinners
  • ⏰ Time: Quick Meals (< 30 min), Slow Cooker, Make-Ahead
  • πŸƒ Diet: Vegetarian, Vegan, Gluten-Free, Keto

Creating a Collection

  1. Go to Collections page
  2. Click "+ New Collection" button
  3. Enter collection details:
    • Name (Required): Collection name (max 255 characters)
    • Description (Optional): What's in this collection?
  4. Click "Create Collection"

Example Collections:

Name: "30-Minute Weeknight Dinners"
Description: "Quick and easy meals for busy evenings"

Name: "Italian Favorites"
Description: "Classic Italian recipes from Nonna's cookbook"

Name: "Meal Prep Sunday"
Description: "Recipes perfect for batch cooking and meal prep"

Adding Recipes to Collections

Method 1: From Collection Page

  1. Open the collection
  2. Click "+ Add Recipe" button
  3. Search/browse for recipes
  4. Click recipe to add it
  5. Recipe appears in collection

Method 2: From Recipe Page

  1. Open the recipe
  2. Click "Add to Collection" button
  3. Select collection(s) from dropdown
  4. Click "Add"
  5. Recipe added to selected collections

Method 3: Bulk Add (Coming Soon)

  • Select multiple recipes
  • Add all to collection at once

Managing Collections

View Collection:

  • Click collection name to open
  • See all recipes in the collection
  • Recipes show full details (image, ingredients, time)

Edit Collection:

  1. Open the collection
  2. Click "Edit" button
  3. Modify name or description
  4. Click "Save Changes"

Delete Collection:

  1. Open the collection
  2. Click "Delete Collection" button
  3. Confirm deletion
  4. Note: Recipes are NOT deleted, only the collection

Remove Recipe from Collection:

  1. Open the collection
  2. Find the recipe
  3. Click "Remove" button next to recipe
  4. Recipe removed from collection (recipe still exists)

Collection Organization Tips

πŸ’‘ Start with Basic Collections

- Breakfasts
- Lunches
- Dinners
- Snacks & Desserts

πŸ’‘ Create Time-Based Collections

- Quick Meals (< 30 minutes)
- Weekend Projects (> 2 hours)
- Slow Cooker Recipes
- One-Pot Meals

πŸ’‘ Organize by Cuisine

- Italian
- Mexican
- Asian
- Mediterranean
- American Comfort Food

πŸ’‘ Create Seasonal Collections

- Summer BBQ
- Fall Comfort Food
- Winter Warmers
- Spring Fresh

πŸ’‘ Use for Meal Planning

- Weekly Rotation
- Monthly Meal Prep
- Holiday Planning
- Party Menus

🌐 Sharing Recipes

Making Recipes Public

Why share recipes?

  • Help other users discover great recipes
  • Build a community recipe collection
  • Get inspiration from others
  • Share family recipes with the world

How to make a recipe public:

  1. Open the recipe in edit mode
  2. Toggle "Make Public" switch to ON
  3. Save the recipe
  4. Your name will appear as the author

What happens when you share:

  • βœ… Other users can view the recipe
  • βœ… Your name appears as author
  • βœ… Others can duplicate your recipe
  • βœ… Recipe appears in public recipe searches
  • ❌ Others CANNOT edit your original recipe
  • ❌ Others CANNOT delete your recipe

Making Recipes Private

To make a recipe private again:

  1. Open the recipe in edit mode
  2. Toggle "Make Public" switch to OFF
  3. Save the recipe
  4. Recipe is now private (only you can see it)

Discovering Public Recipes

Browse Public Recipes:

  1. Go to Recipes page
  2. Click "Browse Public Recipes" tab
  3. See recipes shared by other users
  4. Filter and search as normal

Search All Recipes:

  1. Use the search bar
  2. Toggle "Include Public Recipes"
  3. Search across your recipes + public recipes
  4. Results show author name for public recipes

Using Public Recipes:

  1. Find a recipe you like
  2. Click "Duplicate" button
  3. The recipe is copied to your account
  4. Edit the copy as desired
  5. Your version is private by default

Recipe Attribution

When you duplicate a public recipe:

  • βœ… Original author is credited in notes (Coming Soon)
  • βœ… You can modify your copy freely
  • βœ… Your modifications don't affect the original
  • βœ… You can make your modified version public too

Sharing Best Practices

πŸ’‘ Share Your Best Recipes

  • Don't share everything
  • Share recipes you're proud of
  • Share recipes that worked well
  • Share unique or special recipes

πŸ’‘ Write Clear Instructions

  • Public recipes should be complete
  • Include all steps and tips
  • Test the recipe before sharing
  • Proofread for clarity

πŸ’‘ Give Credit

  • If recipe is from a book, credit the author
  • If recipe is from family, mention that
  • If you modified someone's recipe, credit them

πŸ’‘ Use Good Images

  • A picture is worth 1000 words
  • Use actual photos of your dish
  • Make sure images are appropriate
  • Ensure you have rights to the image

πŸ’‘ Be Responsive (Coming Soon)

  • Respond to comments and questions
  • Update recipe based on feedback
  • Thank users who try your recipe

πŸ’Ύ Import/Export Recipes

Exporting Recipes

Export Single Recipe:

  1. Open the recipe
  2. Click "Export" button
  3. Choose format:
    • JSON - Full recipe data (import back to app)
    • PDF - Print-friendly format (Coming Soon)
    • Plain Text - Copy/paste friendly (Coming Soon)
  4. Save the file

Export Multiple Recipes:

  1. Go to Recipes page
  2. Select recipes (checkboxes)
  3. Click "Export Selected" button
  4. Choose format
  5. Save the file

Export Collection:

  1. Open the collection
  2. Click "Export Collection" button
  3. All recipes in collection exported
  4. Choose format
  5. Save the file

Importing Recipes

Import from JSON:

  1. Go to Recipes page
  2. Click "Import" button
  3. Select JSON file
  4. Preview recipes to import
  5. Click "Import" to confirm
  6. Recipes added to your account

Import from URL: (Coming Soon)

  1. Click "Import from URL"
  2. Paste recipe URL
  3. App parses the recipe
  4. Preview and edit
  5. Save to your account

Import from Recipe Sites: (Coming Soon)

  • Supports: AllRecipes, Food Network, NYT Cooking
  • Automatic parsing of ingredients and instructions
  • Image import
  • Smart categorization

Export/Import Tips

πŸ’‘ Regular Backups

  • Export all recipes monthly
  • Save to cloud storage
  • Keep version history
  • Protect against data loss

πŸ’‘ Share with Family

  • Export recipe collections
  • Email to family members
  • They can import into their accounts
  • Great for holiday recipes

πŸ’‘ Recipe Books

  • Export to PDF (Coming Soon)
  • Create custom cookbooks
  • Print and bind
  • Perfect for gifts

πŸ’‘ Cross-Platform

  • Export from mobile
  • Import on desktop
  • Or vice versa
  • Keep devices in sync

πŸ’‘ Tips & Best Practices

Recipe Organization

Use Descriptive Names

❌ Bad:  "Pasta", "Chicken", "Salad"
βœ… Good: "Creamy Garlic Parmesan Pasta"
         "Honey Garlic Baked Chicken Thighs"
         "Mediterranean Quinoa Salad"

Add Context in Descriptions

"A weeknight-friendly version of lasagna that uses
no-boil noodles and takes just 15 minutes to prep.
Perfect for busy Tuesdays!"

Tag Recipes with Keywords (Coming Soon)

  • Use tags for quick filtering
  • Examples: #vegetarian #glutenfree #quick #freezerfriendly
  • Create your own system

Meal Planning Strategies

The Week-at-a-Glance Method

  • Sunday: Plan the entire week
  • Monday: Prep ingredients
  • Review plan daily
  • Adjust as needed

The 2-Week Rotation

  • Plan 14 different dinners
  • Rotate every 2 weeks
  • Less planning needed
  • Prevents recipe fatigue

The Theme Night Method

Monday: Meatless Monday
Tuesday: Taco Tuesday
Wednesday: Pasta Night
Thursday: Chicken Thursday
Friday: Fish Friday
Saturday: Slow Cooker Saturday
Sunday: Family Dinner

The Batch Cooking Method

  • Sunday: Cook 3-4 recipes
  • Portion into containers
  • Reheat throughout week
  • Great for meal prep

Ingredient Management

Standard Quantities

  • Use consistent units (all cups or all grams)
  • Makes scaling easier
  • Simplifies shopping

Category Everything

  • Always assign ingredient categories
  • Makes shopping lists organized
  • Saves time at the grocery store

Include Prep in Notes

  • "finely chopped"
  • "room temperature"
  • "divided"
  • Helps during cooking

Shopping List Optimization

Shop Once Per Week

  • Plan full week on Sunday
  • Generate complete shopping list
  • One shopping trip
  • Save time and gas

Group Store Trips

  • Generate list for regular stores
  • Separate list for specialty stores
  • Note which store for each item (Coming Soon)

Check Pantry First

  • Review list before generating
  • Remove pantry staples you have
  • Adjust quantities

Time-Saving Tips

Use Quick Filters

  • Filter by "Easy" difficulty
  • Filter by cuisine type
  • Filter by cooking time (Coming Soon)
  • Find recipes fast

Favorite Recipes (Coming Soon)

  • Star your favorites
  • Quick access to go-to recipes
  • Build your personal collection

Duplicate and Modify

  • Found a good recipe?
  • Duplicate it
  • Make your variations
  • Build recipe library

Keyboard Shortcuts

R - Open Recipes
M - Open Meal Planner
C - Open Collections
N - New Recipe
S - Search
/ - Focus search bar
Esc - Close dialogs

πŸ”§ Troubleshooting

Common Issues

Issue: Can't Save Recipe

  • ❓ Cause: Missing required fields
  • βœ… Fix: Ensure recipe has a title
  • βœ… Fix: Check for validation errors (red text)
  • βœ… Fix: Ensure quantities are numbers
  • βœ… Fix: Check internet connection

Issue: Recipe Not Appearing

  • ❓ Cause: Filters hiding recipe
  • βœ… Fix: Clear all filters
  • βœ… Fix: Check search text
  • βœ… Fix: Try different sort order
  • βœ… Fix: Refresh the page

Issue: Can't Add to Meal Plan

  • ❓ Cause: Recipe doesn't exist or is deleted
  • βœ… Fix: Verify recipe exists in recipe list
  • βœ… Fix: Try different recipe
  • βœ… Fix: Reload the page
  • βœ… Fix: Check browser console for errors

Issue: Shopping List Generation Fails

  • ❓ Cause: No meal plans in date range
  • βœ… Fix: Verify meals are planned
  • βœ… Fix: Check date range
  • βœ… Fix: Ensure meals aren't marked as cooked
  • βœ… Fix: Try shorter date range

Issue: Ingredients Not Combining

  • ❓ Cause: Different names or categories
  • βœ… Fix: Use consistent ingredient names
  • βœ… Fix: Use consistent categories
  • βœ… Fix: Combine manually after generation

Issue: Can't See Public Recipes

  • ❓ Cause: Filter settings or no public recipes exist
  • βœ… Fix: Toggle "Show Public Recipes"
  • βœ… Fix: Clear search and filters
  • βœ… Fix: Try different search terms

Error Messages

"Recipe title is required"

  • Add a title to your recipe (1-255 characters)

"Recipe not found"

  • Recipe was deleted or ID is invalid
  • Go back and select a different recipe

"You do not have access to this recipe"

  • Recipe is private and belongs to another user
  • Ask owner to make it public or share with you

"Validation error"

  • Check all fields for invalid data
  • Ensure quantities are numbers
  • Ensure times are non-negative
  • Ensure servings are positive

"Collection name already exists"

  • You already have a collection with this name
  • Choose a different name
  • Or edit the existing collection

Performance Issues

Slow Loading:

  • βœ… Close unused browser tabs
  • βœ… Clear browser cache
  • βœ… Check internet connection
  • βœ… Try different browser

Lag When Typing:

  • βœ… Reduce number of ingredients displayed
  • βœ… Close other apps
  • βœ… Restart browser
  • βœ… Check for browser updates

Getting Help

Still Having Issues?

  1. Check Browser Console:

    • Press F12
    • Look for red errors
    • Screenshot and report
  2. Try Different Browser:

    • Test in Chrome, Firefox, or Safari
    • Update to latest version
  3. Clear Cache and Cookies:

    • Settings β†’ Privacy β†’ Clear browsing data
    • Select "Cached images and files"
    • Try again
  4. Contact Support:


❓ FAQ

General Questions

Q: Is Recipe Integration free? A: Yes! All recipe features are included with your account at no extra cost.

Q: How many recipes can I create? A: There's no limit! Create as many recipes as you need.

Q: Can I use recipes without meal planning? A: Absolutely! Recipes are useful on their own for reference and organization.

Q: Are my recipes private by default? A: Yes! All recipes are private unless you explicitly make them public.

Recipe Questions

Q: Can I edit a recipe after saving it? A: Yes! Click the recipe, then click "Edit" to make changes.

Q: What happens if I delete a recipe that's in my meal plan? A: The meal plan entry will be removed automatically.

Q: Can I add images to recipes? A: Yes, via image URLs. Direct upload is coming soon!

Q: Can I have recipes without ingredients? A: Yes, though ingredients are recommended for shopping list generation.

Q: What recipe formats can I import? A: Currently JSON. URL import and recipe site parsing coming soon.

Meal Planning Questions

Q: Can I plan more than one week ahead? A: Yes! Plan as far ahead as you like.

Q: Can I assign multiple recipes to one meal slot? A: Not currently. You can create a custom recipe that combines dishes.

Q: What if I change my mind about a planned meal? A: Simply delete it and add a different recipe, or edit the date.

Q: Can I copy a meal plan to another week? A: Not yet, but this feature is planned! Currently, add recipes manually.

Q: How do I plan for holidays or special occasions? A: Create a collection for the occasion, then add recipes to your meal plan.

Shopping List Questions

Q: Will the app convert units (cups to ml)? A: Not yet. Use consistent units for best results. Unit conversion coming soon!

Q: Can I edit the generated shopping list? A: Yes! Once added to a grocery list, edit items as normal.

Q: What if I have two recipes with "chicken" - will they combine? A: Only if the ingredient names match exactly (case-insensitive).

Q: Can I generate a list for just one day? A: Yes! Set start date and end date to the same day.

Q: Will it include items from cooked meals? A: No, meals marked as cooked are excluded from shopping list generation.

Collection Questions

Q: Can a recipe be in multiple collections? A: Yes! Add recipes to as many collections as you want.

Q: Can I share collections with others? A: Not directly, but you can export the collection and share the file.

Q: What happens if I delete a collection? A: Only the collection is deleted. Recipes remain intact.

Q: Can I reorder recipes in a collection? A: Not yet. Currently, they're sorted by date added.

Sharing Questions

Q: Who can see my public recipes? A: All logged-in users can discover and view them.

Q: Can someone edit my public recipe? A: No. They can duplicate it and edit their copy.

Q: If I make a recipe private, what happens to copies others made? A: Their copies remain. Only new users can't see the original.

Q: Can I see who has duplicated my recipe? A: Not currently. Analytics feature coming soon!

Q: How do I credit a recipe source? A: Add credit in the description or instructions field.

Technical Questions

Q: Does Recipe Integration work offline? A: Viewing recipes works offline. Creating/editing requires internet.

Q: Can I use Recipe Integration on mobile? A: Yes! The interface is fully responsive and mobile-friendly.

Q: What browsers are supported? A: All modern browsers (Chrome, Firefox, Safari, Edge).

Q: Is there an API for recipes? A: Yes! See the API Reference documentation.

Q: Can I sync recipes across devices? A: Yes! Recipes are stored in the cloud and sync automatically.


πŸŽ‰ Conclusion

Congratulations! You're now ready to master Recipe Integration in the Grocery List app. Remember:

  • βœ… Start with a few favorite recipes
  • βœ… Plan meals one week at a time
  • βœ… Use collections to stay organized
  • βœ… Generate shopping lists to save time
  • βœ… Share your best recipes with the community

Happy Cooking! πŸ³πŸ‘¨β€πŸ³πŸ‘©β€πŸ³


Need More Help?


Last Updated: October 2025 | Version 1.0