Use Wocheneinkauf from setup to checkout.

Getting Started

Wocheneinkauf organizes everything inside libraries. A library contains its own catalog, recipes, planning selections, active shopping run, history, and sharing state.

1. On first launch, choose the display name other people should see in shared lists.
2. Create your first library when the app asks for one.
3. Use Settings to create more libraries or switch between existing libraries.
4. Keep separate libraries for separate households, trips, or planning contexts.

Catalog

The catalog stores reusable grocery items. Recipes and basic plan items both draw from this catalog, and item details are available from the places where items appear.

1. Use the Basics search field in Plan to find or create reusable basic items.
2. Use the ingredient picker while editing a recipe to add catalog items to recipes.
3. Long-press a basic or ingredient row and choose Item Details.
4. Edit the name, category, default amount, or recipe availability from the item detail page.

Recipes

Recipes turn repeated meals into reusable planning units. A recipe stores the ingredients and amounts you usually need.

1. In Plan, use the Recipes search field to find a recipe or type a new recipe name.
2. Tap the create row when the recipe does not already exist.
3. Add ingredients from the catalog.
4. If an ingredient is missing, search for it and create it from the picker.
5. Set ingredient amounts and units, then reorder ingredients if needed.
6. Save the recipe. It now appears in the Plan recipe list.

Planning a Shop

The Plan tab builds the next shopping run from selected recipes and basics. Amounts, units, and notes changed in Plan affect the current shop only; category changes update the reusable catalog item.

1. Use the Recipes search field to find existing recipes or create a new one.
2. Select one or more recipes.
3. Tap the ingredients row under a selected recipe to expand it.
4. Turn off an ingredient if you do not need it this time.
5. Tap an ingredient amount to edit the quantity or unit for this shop only.
6. Use the Basics search field to find a recurring staple or quickly type a new item.
7. Tap an existing result to select it, or choose a category and tap the create row to add a missing item.
8. Expand a Basics category when you want to browse recurring staples by category.
9. Use a basic row's category action to move it to another catalog category without leaving Plan.
10. Long-press a recipe and choose Recipe Details to edit, delete, or review it.
11. Long-press a basic or ingredient row and choose Item Details to edit the reusable catalog item.
12. Tap a selected basic item amount to change the quantity or unit for this shop only.
13. Long-press a selected basic to choose note or category actions; long-press an included recipe ingredient to add a note for this shop.
14. Open Activity from the Plan toolbar to review who changed selections, amounts, units, notes, clear actions, or history restores.
15. Use the Plan menu to collapse expanded sections, hide unselected recipes and basics, or edit Basics category order.
16. Use Clear if you want to remove the current draft selections.

Shopping

Starting a shop creates an active run in the Shop tab. The run merges compatible amounts and groups open items by category.

1. Build a draft in Plan.
2. Tap the bottom Start Shopping button.
3. Open Shop and check off items as you buy them.
4. Open the completed section if you need to uncheck an item.
5. Remove a row from the run if it no longer belongs on the list.
6. Finish the run when shopping is done, or discard it if the run should not be kept.

Add more items to an active run

1. Leave the active run open in Shop.
2. Return to Plan and select more recipes or basics.
3. Tap the bottom Add button.
4. The app appends only new open items that are not already represented in the run.

History

Finished and discarded shopping runs create history entries. History helps you repeat a week without rebuilding the whole plan.

1. Open Plan.
2. Tap the history button in the top right.
3. Choose a previous entry to review its recipes, ingredients, basics, amounts, and notes.
4. Restore it into the current draft from the entry detail view if you want to use it again.
5. If the draft already has selections, confirm that you want to replace them.

Sharing Libraries

With Premium, owned libraries can be shared with other iCloud users. Shared libraries keep planning, shopping, and history in one household source of truth.

1. Open Settings.
2. Select a library you own.
3. Tap Manage Sharing. If Premium is not active yet, unlock it with a purchase, Restore Purchases, or an Apple offer code.
4. Use Apple’s sharing sheet to invite people and manage permissions.
5. Ask invited people to accept the shared library through iCloud.

Troubleshooting

iCloud or sharing does not appear

• Confirm that iCloud is enabled on the device.
• Confirm that the app is allowed to use iCloud.
• Open the app again after accepting a shared library invitation.

A shared library is read-only

• Check the permission shown in Settings.
• Ask the library owner to update sharing permissions if you need edit access.

When contacting support

• Include the app version and build number.
• Include your device model and iOS version.
• Say whether iCloud sync or sharing is involved.
• Describe what you expected and what happened instead.

Email support@carullo.dev when you need help.