User Manual

Everything you need to know to get the most out of recipeReader.

Table of Contents

Getting Started

First Launch

When you open recipeReader for the first time, you'll see a 4-page welcome walkthrough introducing the key features: importing, family sharing, and cooking mode. Swipe through and tap Get Started on the last page.

The Five Tabs

On iPhone, recipeReader has five tabs at the bottom of the screen:

  1. Recipes — Your personal recipe collection
  2. Planner — Weekly meal planner (shared with household)
  3. Family — Recipes shared with your family groups
  4. Activity — Timeline of what's been cooked, added, and shared
  5. Settings — AI config, categories, collections, export, and about
iPad & Mac: On iPad or Mac, the five tabs become a sidebar on the left. Same features, more room to browse.

Importing Recipes

Four Ways to Import

Tap the + button in the top-right of the Recipes tab and choose Import from Photo/Text. You'll see four import modes:

  1. Photo — Select photos of recipe cards, cookbook pages, or handwritten notes from your camera roll. You can select up to 20 pages.
  2. PDF — Choose a PDF file. Each page is rendered and scanned.
  3. URL — Paste a recipe URL from any website. The app tries to extract structured recipe data (JSON-LD) first, then falls back to AI parsing.
  4. Text — Paste or type recipe text directly.

How Parsing Works

After you select your source, tap Analyze Recipe. You'll see a progress bar:

If AI is unavailable (no API key or no internet), the app falls back to a local heuristic parser that works offline.

Reviewing Before Saving

After analysis, you'll see the extracted recipe in a Review section. Check the title, ingredients, and steps. Edit anything that looks wrong. When you're happy, tap Save Recipe.

Duplicate detection: If a recipe with the same title or source URL already exists, you'll get a warning. Change the title to save it as a separate recipe.

Importing from Safari

If the Share Extension is set up, you can share a recipe URL directly from Safari using the iOS share sheet. The URL will be waiting for you next time you open recipeReader.

Clipboard Detection

If you copy a recipe URL in another app, recipeReader will detect it when you open the app and offer to import it.

Organizing Recipes

Categories

Recipes are auto-tagged with categories like Breakfast, Dinner, Seafood, Dessert, etc. based on their ingredients and title. You can also add custom categories in Settings > Manage Categories.

On the Recipes tab, the category chips bar lets you filter by category. Each chip shows how many recipes match. Tap multiple chips to filter by several categories at once.

Collections

Collections are like playlists for recipes. Create collections like "Weeknight Dinners", "Holiday Favorites", or "Meal Prep" in Settings > Manage Collections. Each collection gets a custom icon.

Add recipes to collections from the recipe editor, or by long-pressing a recipe and choosing Add to Collection.

Filter by collection using the orange collection chips above the category bar.

Searching

The search bar at the top of the Recipes tab searches across recipe titles, ingredients, steps, notes, categories, and collections. It's a full-text search — type "chicken" to find any recipe that uses chicken.

Sorting

Tap the sort icon (up/down arrows) in the toolbar to choose from 7 sort options:

Favorites

Tap the heart icon in the toolbar to show only favorites. You can favorite a recipe by:

Multi-Filter

All filters work together. You can combine a collection + multiple categories + favorites + search. The toolbar shows an active filter count badge in orange. Tap it to clear all filters at once.

Context Menus

Long-press any recipe for quick actions: Start Cooking, Favorite, Add to Collection, Share, or Delete.

Cooking Mode

Starting Cooking Mode

Open any recipe and tap the orange Start Cooking button. This opens a full-screen cooking view.

Navigating Steps

Built-in Timers

If a step mentions a time (like "bake for 25 minutes" or "simmer 10 min"), a timer button appears below the step text. Tap it to start a countdown timer.

Ingredient Checklist

Tap the checklist icon in the top-right to switch from steps to the ingredient checklist. Tap each ingredient as you prep it — it gets a green checkmark and strikethrough.

Finishing

On the last step, a green Finish button appears. Tapping it:

Meal Planning

The Weekly View

The Planner tab shows a 7-day week. Today is highlighted in blue. Each day shows planned meals grouped by type (breakfast, lunch, dinner, snack).

Adding Meals

  1. Tap the + button (top-right or on any day)
  2. Choose the meal type (breakfast, lunch, dinner, snack) with the segmented picker
  3. Search or browse your recipes
  4. Tap a recipe to add it to that day

Navigating Weeks

Use the left/right arrows to browse forward and backward by week.

Household Sharing

If you're connected to a Household group, your meal plan is automatically shared with everyone in the household.

Grocery List from Plan

Tap the cart icon to generate a combined grocery list from all recipes in the current week — including meals added by household members.

Grocery Lists

Generating a Grocery List

You can generate a grocery list two ways:

  1. From selected recipes: On the Recipes tab, tap the cart icon, select recipes with checkmarks, then tap "Grocery List"
  2. From your meal plan: On the Planner tab, tap the cart icon for the current week

How It Works

Checking Items

Tap any item to uncheck it (exclude from the list). The footer shows how many items are selected.

Exporting

Family Sharing

Two Sharing Tiers

recipeReader has two separate family groups, each with its own members and invite links:

🏠

Household

For people living together. Shares recipes, meal plans, and grocery lists. Everyone sees each other's cooking activity.

👪

Extended Family

For relatives outside your home. Share just your favorite recipes. They don't see your daily meal plans or grocery lists.

Setting Up a Group

  1. Go to the Family tab and tap Manage (top-right)
  2. Choose Household or Extended Family with the segmented picker
  3. Tap Create Group
  4. Invite members by entering their Apple ID email
  5. Send them the invite link (via Messages, email, etc.)

Joining a Group

  1. Open the invite link you received, OR
  2. Go to the Family tab, scroll down, and paste the invite link in the "Join" field

Sharing a Recipe

  1. Open any recipe and scroll to Share to Family
  2. Choose Household or Extended Family
  3. The recipe appears in the Family tab for all group members

Viewing Shared Recipes

The Family tab shows shared recipes. Use the segmented picker at the top to switch between Household and Extended Family recipes. All the same filtering, sorting, and search tools are available.

AI Settings Sharing: If you have an AI API key configured, you can share it with your household in Settings. Family members can then import recipes with AI assistance without needing their own key.

Ratings & Cook Notes

Rating a Recipe

Open any recipe and tap the stars in the "My Rating" section to rate it 1-5 stars. Tap the same star again to clear the rating. Rated recipes show stars on their card in the list.

Cook Notes

Tap Add Cook Notes below the rating to write personal annotations — things like "double the garlic", "used almond milk instead", or "kids loved this one". These notes persist across sessions and are separate from the recipe's original notes.

Sorting by Rating

Use the sort menu and choose Highest Rated to see your best recipes first.

Sharing & Printing

Sharing Options

In any recipe's detail view, tap the share icon in the top-right for options:

Version History

If a recipe has been edited, a clock icon appears in the toolbar. Tap it to see the previous version and optionally restore it. The current version becomes the new previous version, so you never lose anything.

Settings & Preferences

AI Recipe Parsing

Toggle Enable AI Assist to turn AI parsing on or off. If enabled, you can:

If AI is unavailable, the app falls back to a local parser that works offline.

Measurement System

Choose between Imperial (US) and Metric. This affects unit conversion throughout the app.

Manage Categories

Add, delete, and reorder recipe categories. Categories are auto-suggested during import but you can customize the list.

Manage Collections

Create and manage recipe collections. Each collection has a name and icon. Drag to reorder.

Cooking Insights

View your cooking stats: total recipes, times cooked, this month's activity, most-cooked recipes, average rating, and category breakdown. Get smart suggestions like "Try something new" and "Revisit a classic".

Export & Import

Export all your recipes to a JSON file for backup. Import from a previously exported file. See the Backup & Export section for details.

About

App version, feature summary, rate on the App Store, and tip jar.

Siri & Widgets

Siri Shortcuts

Two built-in Siri commands:

Home Screen Widgets

Two widgets available (add via long-press home screen > "+" > search "recipeReader"):

Home Screen Quick Actions

Long-press the recipeReader app icon for quick actions:

Backup & Export

Exporting

  1. Go to Settings > Export & Import
  2. Tap Export All Recipes
  3. Tap Share Export File to save or send the JSON file

The export includes all recipe data: title, ingredients, steps, ratings, cook notes, categories, collections, and cook counts.

Importing

  1. Go to Settings > Export & Import
  2. Tap Import from File
  3. Select a previously exported JSON file
Note: Imported recipes are added to your collection — they don't replace existing recipes. If a recipe with the same title exists, both will appear.

iCloud Sync

Your recipes automatically sync via iCloud across all your devices. You don't need to export/import for multi-device use — that's handled by CloudKit. Export is for backup and for sharing the raw data with others.