Frequently Asked Questions

Quick answers to the most common questions from the family.

Importing Recipes

How do I add a recipe from a website?

Tap the + button on the Recipes tab, choose Import from Photo/Text, switch to the URL tab, paste the website address, and tap Analyze Recipe. The app will extract the recipe automatically.

You can also copy a recipe URL in Safari — when you open recipeReader, it may detect the URL and offer to import it.

Can I import a recipe from a photo of a cookbook?

Yes! Tap +, choose Import, stay on the Photo tab, and select photos of the recipe pages. You can select up to 20 pages. The app uses OCR (text recognition) to read the text, then AI to structure it into ingredients and steps.

Do I need an API key to import recipes?

No. Without an API key, the app uses a built-in local parser. It works well for clearly formatted recipes. An AI key (OpenAI or Claude) gives better results with messy text, handwriting, or unusual layouts.

If someone in your household has a key configured, they can share it with you via Settings > Sync to Family.

It says "duplicate recipe detected" — what do I do?

The app prevents saving a recipe with the same title or source URL as an existing one. If you want to save it anyway, change the title slightly (e.g., add "v2" or "Mom's version") before saving.

Cooking

How do I use the step-by-step cooking mode?

Open any recipe and tap the orange Start Cooking button. Swipe left/right to move between steps. Your screen will stay on while cooking.

How do timers work?

If a step mentions a time (like "bake for 25 minutes"), a timer button appears below the step. Tap it to start a countdown. You can run multiple timers at once — they show as pills at the top of the screen. If you leave the app, you'll get a notification when the timer is done.

What happens when I tap "Finish"?

It records that you cooked the recipe — updating your cook count, last-cooked date, and activity feed. You might also see a celebration if it's a milestone (like your 10th cook!).

Can I check off ingredients while cooking?

Yes, two ways: (1) In cooking mode, tap the checklist icon in the top-right to switch to the ingredient view. (2) In the regular recipe detail view, tap any ingredient to check it off.

Meal Planning

How do I add a recipe to the meal plan?

Go to the Planner tab, tap the + on any day (or the + in the toolbar), choose the meal type (breakfast/lunch/dinner/snack), and pick a recipe.

Can my spouse see the meal plan?

Yes! If you're both in the same Household group, the meal plan syncs automatically. Each entry shows who added it. Pull down to refresh and see the latest from your household.

How do I make a grocery list from the meal plan?

On the Planner tab, tap the cart icon in the toolbar. It generates a combined grocery list from all recipes planned for the current week — including meals added by household members.

Family Sharing

What's the difference between Household and Extended Family?

Household is for people living together (like you and your spouse). It shares recipes, meal plans, and grocery lists. Extended Family is for relatives outside your home (like parents or siblings). It only shares recipes — not your daily meal plans.

How do I invite someone to my family group?
  1. Go to Family tab > Manage
  2. Choose Household or Extended Family
  3. Enter their Apple ID email and tap Send Invite
  4. Copy the invite link and send it to them via Messages or email
How do I join a family group someone invited me to?

Open the invite link they sent you. If that doesn't work, go to the Family tab, scroll down, and paste the invite link in the "Join" field.

Can I be in both Household and Extended Family?

Yes! They're completely separate groups with independent member lists. You might be in a Household group with your spouse and an Extended Family group with your parents and siblings.

Do I need iCloud to use family sharing?

Yes. Family sharing uses Apple's CloudKit service, which requires an iCloud account. Make sure you're signed in to iCloud in your device Settings.

Organization

How do I create a recipe collection?

Go to Settings > Manage Collections. Type a name, pick an icon, and tap Add. Then add recipes to it from the recipe editor or by long-pressing a recipe and choosing "Add to Collection".

Can I filter by multiple categories at once?

Yes! Tap multiple category chips to select them. The list shows recipes matching ANY of the selected categories. The orange filter badge in the toolbar shows how many filters are active. Tap it to clear all filters.

How do I find a recipe I cooked recently?

Use the sort menu and choose Recently Cooked. Recipes you've cooked most recently appear first. You can also choose Most Cooked to see your all-time favorites.

Sharing & Printing

How do I share a recipe with someone outside the app?

Open the recipe and tap the share icon (square with arrow). Choose Share as Text for a simple text version, or Share as Image Card for a beautiful visual card with the recipe photo and details.

Can I print a recipe?

Yes! Tap the share icon and choose Print Recipe. It creates a clean, formatted printout via AirPrint with the title, ingredients, steps, notes, and your personal cook notes.

Data & Privacy

How do I back up my recipes?

Go to Settings > Export & Import and tap Export All Recipes. This creates a JSON file you can save to Files, email to yourself, or share. To restore, use Import from File.

Your recipes also sync automatically via iCloud, so they're backed up in the cloud as long as you're signed in to iCloud.

Is my data private?

Yes. Your recipes are stored on your device and in your private iCloud account. Shared recipes are only visible to the specific family group members you've invited. API keys are stored in the iOS Keychain (encrypted hardware storage), never in plain text.

Can I restore a recipe I accidentally edited?

If you've edited a recipe, a clock icon appears in the toolbar of the recipe detail view. Tap it to see the previous version and optionally restore it.

Troubleshooting

The app says "You're offline" — what should I do?

The app works fine offline for browsing, cooking, and editing recipes. The orange banner just means features that need internet (like family sync, AI parsing, and web import) are temporarily unavailable. It will disappear when you reconnect.

Family recipes aren't showing up for a member — how do I fix it?
  1. Make sure both people are signed in to iCloud
  2. On the Family tab, pull down to refresh
  3. Go to Manage > Troubleshooting > Re-sync Recipes to CloudKit
  4. Check that the member has accepted the invite link
I can't create a family group — it says "schema not deployed"

This happens the first time. The CloudKit schema needs to be initialized by running the app from Xcode on a Simulator, then deploying the schema to production in the CloudKit Dashboard.

How do I switch between Imperial and Metric units?

Go to Settings > Preferences > Measurement System and choose Imperial or Metric.