The iPhone app (coming soon)

The Mirepoix iPhone app isn’t available yet. It’s coming, but it isn’t in the App Store, and there’s no way to download it or sign up for it today. Until it arrives, install Mirepoix from Safari to put it on your home screen. This page describes what the app will add once it’s out.

What it is

The iPhone app is the Mirepoix website in an app of its own, with Recipes, Menu, Pantry, and Groceries as tabs along the bottom. Every page works as it does on the web. A change you make in the app reaches your other devices and the other members of your kitchen, and theirs reach the app.

You’ll need an iPhone with iOS 17 or later. The Apple Watch app needs watchOS 11 or later.
Sign in with an emailed code, the same 8-character code the website sends, or with a passkey, as on the website.
The app signs in on its own. Signing in to the app doesn’t sign in Safari, and the app shows as its own row, Mirepoix app on iPhone, under Where you’re signed in.
If your sign-in ends, the app goes back to Mirepoix’s front page so you can sign in again. A page you’re not allowed to open doesn’t sign you out.
The app keeps an agent token for the kitchen it’s in. Mirepoix creates it while you’re signed in to the app, with read-and-change access, and shows it on your Account page on the app’s row under Where you’re signed in. It ends with the app’s sign-in. The app gets it whether the kitchen’s agent access is on or off, and turning agent access off doesn’t delete it.

Everything below is what the app adds beyond the website.

Keep your shopping list on the Home Screen, the Lock Screen, or in StandBy. Add it the way you add any widget: look for mirepoix in the widget gallery, where the widget is called Groceries.

Where	Size	What it shows
Home Screen or StandBy	Small	How many items are left to buy, and the next 3
Home Screen	Medium	The count and the next 6 items, in two columns, with their aisles and amounts
Home Screen	Large	The count and the next 12 items, with their aisles and amounts
Lock Screen	Rectangular	The count and the next 2 items
Lock Screen	Circular	The count
Lock Screen	Inline	One line, such as “5 groceries”

Items come in aisle order, the order the Groceries page lists them. On the medium and large sizes, “+3 more” counts what didn’t fit.
Tap the widget to open the app on Groceries.
The widget shows the list as the app last saw it. While the app is open, that’s the list as it is now. Groceries loads when the app opens, whichever tab you’re on. So the widget follows changes from your other devices and your kitchen’s members as they arrive. It updates again when you leave the app, and from time to time in the background when iOS allows. The Home Screen sizes say when, like “Updated 5:42 PM”.
Items you check off or skip in the app leave the widget at once, even with no signal, while the change waits to go up. A change that waits more than a week is too old to sync, so its item comes back on the widget the next time the app updates it.
Once the list is more than 12 hours old, the Home Screen sizes dim and say Open mirepoix to refresh. The Lock Screen sizes hide the items and show a dash in place of the count. Opening the app brings them up to date.
Until the app has seen your list, the Home Screen sizes say Open Groceries in mirepoix to show your list here.
If the app finds your sign-in has ended, the widget hides your list and says Sign in to mirepoix to show your list here. If the app needs an update to read your list, it says Update mirepoix to show your list here. On the Lock Screen, the rectangular and inline sizes say Sign in to mirepoix or Update mirepoix.
Signing out of the app clears the widget. So does switching the app to another kitchen.

Siri and Shortcuts

Say these to Siri. Each one needs “mirepoix” in it. The grocery and Pantry ones do their work without opening the app, and Siri tells you how it went.

Say	What happens
“We’re out of something in mirepoix”	Siri asks “What are you out of?” Say olive oil, and it goes on your grocery list. A name your kitchen doesn’t have yet is added as one of its own.
“We’ve got plenty of something in mirepoix”	Siri asks “What have you got plenty of?” Say rice, and it comes off your grocery list and is marked stocked, so the Pantry asks about it again in a week, as 1 week under Have it does — unless it’s set to Don’t ask, which goes back to Not asking. A name your kitchen doesn’t know changes nothing, and Siri says so.
“Do we have eggs in mirepoix”	Says whether eggs are on hand, on your shopping list, or due for a check, or that there’s no record of them.
“Add to my mirepoix list” or “Add to my grocery list in mirepoix”	Siri asks what to add. Name one thing or several, such as “eggs, lemons, and olive oil”.
“Check off an item in mirepoix”	Siri asks “Which item?” Say milk, and it’s checked off your grocery list. If more than one item matches, Siri asks which.
“What’s on my mirepoix list”	Says how many items are on your grocery list and how many are checked off, then names up to five still to buy, in list order, and how many more there are.
“Open Groceries in mirepoix”	Opens the app on that tab. Menu, Recipes, and Pantry work the same way, and so do “Show my Groceries in mirepoix” and “mirepoix Groceries”. Siri also knows Groceries as your grocery list or shopping list.
“Search in mirepoix” or “Find a recipe in mirepoix”	Siri asks what you’re looking for, then the app opens search with your words already in it and the results showing.

Only “Do we have” names the ingredient as you say it. There, Siri listens for the ingredients your kitchen bought most recently, and when it doesn’t catch the name, it asks for it.
The ones that change your list or Pantry ask what you mean first. “We’re out of” and “We’ve got plenty of” look for your answer among your kitchen’s ingredients and their other names, and “Check off” looks for it among the items still on your list.
The app keeps your kitchen’s ingredient names on your iPhone so Siri can recognize them, and forgets them when you sign out or switch kitchens. Data and privacy says what it keeps.
Out of, plenty of, and adds can run on a locked iPhone, where iOS allows it. With Apple Intelligence on, iOS asks you to unlock before Siri runs any app’s action on a locked iPhone, Apple’s own Reminders included.
Do we have, check off, and what’s on my list always ask you to unlock first.
To add several things without saying “mirepoix”, use Add with Siri through Reminders.

What Siri says

When it works, Siri says your kitchen’s own answer, such as “Milk is on your list.” or “Rice is stocked, due again in a week.” Otherwise it says why:

What happened	What Siri says
No signal, on an add	“You’re offline. Open the app to save it for later?” (see below)
No signal, on anything else	“You’re offline, so that didn’t go through.”
A change went out, but no answer came back	“I’m not sure that went through. Open the app to check.”
A question went out, but no answer came back	“No answer yet. Try again in a moment.”
The app hasn’t been opened since it was installed, you’re signed out of it, or it needs to reconnect	“Open the app once to connect Siri.”
Your iPhone has restarted and hasn’t been unlocked since	“Unlock your iPhone once, then try again.”
Too many requests at once	“Busy right now. Try again in a moment.”
The app needs an update to do this	“Update the app to use this.”
Siri offered a name from the kitchen the app was in before it switched	“That’s from another kitchen. Try again.”

An add with no signal. When Siri asks to open the app, go ahead, and the app saves each item on your iPhone and adds it once it can reach your kitchen again, the way changes you make without a signal go up later. If you don’t, nothing is added. Then Siri says how each item went, with milk as the item:

What happened	What Siri says
Saved to send later	“Saved milk. It’ll reach your grocery list as soon as it can be sent.”
Saved, to add once your sign-in is confirmed	“Saved milk. It’ll be added once your sign-in is confirmed.”
It’s on your list	“Added milk to your grocery list.”
The app has no kitchen open	“Open your kitchen in the app, then try again.”
You’re signed out of the app	“Sign in to the app first, then try again.”
The app is in a different kitchen from when you asked	“The app is in another kitchen now, so nothing was added.”
Nothing was added	Why, such as “You’re offline, so nothing was added.”

In the Shortcuts app, each of these is an action you can build into your own shortcuts: We’re Out Of, We’ve Got Plenty Of, Do We Have, Add to List, Check Off, What’s on the List, Open Tab, and Search. A shortcut can fill in the item for you, so one tap adds milk without Siri asking. Add to Groceries, the older add, is still there too: it opens the app to add the item, and says the same things as an add with no signal.

Add with Siri through Reminders

Siri can already add to a list in Apple’s Reminders app, several things in one breath, without you naming an app. Turn this on, and the app moves what lands on one Reminders list onto your grocery list.

In the app, tap mirepoix, then your initials at the top of the menu, to open your Account page.
Under iPhone app, turn on Add with Siri through Reminders.
When iOS asks, allow mirepoix full access to your reminders.
Pick a list, then tap Done.

The row now names the list you picked, and the items already on it move onto your grocery list.

Pick a list named Groceries. If you have one, the picker starts with it selected. Siri knows it as your grocery list, so you can say “Add eggs, lemons and olive oil to my grocery list” without naming an app. Siri adds to that list in Reminders, and mirepoix moves them onto your grocery list. Any list you can change works too: say its name in place of “my grocery list”.

Which phrase does what. With “mirepoix” in it, as in “Add to my grocery list in mirepoix”, Siri asks the app itself, as in the table above. Without it, Siri adds to Reminders, and the app picks the items up from there.

What happens to the reminders

Each open reminder becomes one item on your grocery list, named by its title. Only the title is sent: the reminder’s notes, dates, and other details go when it’s deleted. Completed reminders are left alone.
Once Mirepoix confirms the item is on your grocery list, or was already there, the app deletes the reminder. A reminder whose item couldn’t be added stays in Reminders, and the app tries it again next time.
The same item twice, such as “milk” and “Milk”, becomes one item, and both reminders are deleted.
An item you’d checked off goes back on your list, unchecked.
Up to 50 items move at a time. The rest move the next time.
A reminder longer than 100 characters stays in Reminders and isn’t sent. Shorten it there, and it moves next time.
Items go to the kitchen the app is in. Switch the app to another kitchen, and they go to that one.

A shared list. If the list is shared with other people in Reminders, what they add moves onto your grocery list too, and deleting it removes it from the list for everyone. The row always says so: “If this list is shared, items others add move into Mirepoix and disappear from Reminders for everyone.”

When items move

When you open the app, and right after it signs in to a kitchen.
While the app is open, whenever something changes in Reminders, so a Siri add moves within moments.
In the background, from time to time, when Background App Refresh is on and iOS allows it. iOS decides when.

With no signal, nothing moves, and the reminders wait in Reminders for the next time.

What the row says

The row shows	What it means
The list’s name under the switch	It’s on, and items move from that list.
Checking…	The app hasn’t answered yet.
Open Settings, in place of the switch	The app doesn’t have access to your reminders: you didn’t allow it, or you took it away. Tap Open Settings, allow full access to Reminders on mirepoix’s page there, then come back to the app. If you’d already picked a list, it’s on again. Otherwise, turn it on.
“Reminders access is restricted on this iPhone.”	Something on your iPhone, such as Screen Time or a device-management profile, doesn’t allow access to Reminders, so there’s no switch.
“The list you chose is gone. Choose another.”	The list was deleted, or can’t be found, so the setting turned itself off. Turn it on to pick another.
“1 reminder is too long to import”, or “3 reminders are too long to import”	Those reminders are over 100 characters, so they’re staying in Reminders. Shorten them there.

Turn it off

Turn off Add with Siri through Reminders on your Account page. The app forgets the list and stops moving items. Reminders already on the list stay there.
Turning it off doesn’t take back the app’s access to your reminders. iOS gives an app no way to do that. To take it back yourself, open Settings, then Privacy & Security › Reminders › mirepoix.
Signing out of the app turns it off too, and forgets the list, so the next person to sign in on your iPhone doesn’t get your reminders. After you sign in again, turn it back on.

The app keeps the list you chose only on your iPhone. Data and privacy says what it reads from Reminders.

Links open in the app

Tap a link to a Mirepoix recipe, or a Menu, Pantry, or Groceries page, in Messages, Mail, or Notes, and it opens in the app instead of Safari. So does one scanned from a QR code.

A link to a recipe opens on the Recipes tab, and Back leads to your recipe list. A link to the recipe list, or to the Menu, Pantry, or Groceries page, opens that tab.
A link into another of your kitchens switches the app to that kitchen, then opens the page.
A link to another kitchen’s page you can’t open, such as one in a kitchen you’re not in, shows “This page isn’t here” or “This page isn’t available”. Back returns you to where you were. You stay signed in to your own kitchen, and your widget and watch keep your list.
Another kitchen’s published recipes open in your own kitchen’s tabs, without switching kitchens.
Signed out, a link to a page that needs you signed in shows sign-in first. Sign in within 10 minutes, and the app then opens the page. A published kitchen’s recipe opens without signing in.
Invitation links open in the app too.

Other Mirepoix links still open in Safari, including print pages, Kitchen Settings, and Mirepoix’s front page.

Spotlight and Handoff

Find a tab from Spotlight. Search for “Groceries” or “Pantry”, and the mirepoix result opens that tab.
Find recipes you’ve opened. Each recipe you open in the app shows up in Spotlight by name. Tap it to open the recipe in the Recipes tab. Siri Suggestions can also learn the recipes you open often.
Pick up a recipe on another device. With a recipe open in the app, your Mac or iPad signed in to the same Apple Account can open it in Safari through Handoff. Handoff passes along only the recipe’s address and title.

These recipe entries stay on your iPhone and aren’t added to any public search index. The app forgets them when you sign out or switch kitchens.

Quick actions

Touch and hold the app’s icon on the Home Screen to jump straight to Recipes, Menu, Pantry, or Groceries. Each opens that tab at its top.

Save a recipe from Safari

The app adds mirepoix to Safari’s Share menu, so you can save a recipe page to import later.

Open a recipe page in Safari.
Tap the Share button.
Tap mirepoix.

The sheet names the page and says it’s saved to your kitchen and waiting in Pending imports, then closes itself. The recipe waits under Pending Imports at the top of your recipes list, the same place the import bookmarklet saves to. Open it there, and Mirabel asks before importing anything.

Sharing only saves the page; it doesn’t start an import. It uses the app’s sign-in, so sign in to the app first. It saves to the kitchen the app is in.

While it saves, the sheet’s button reads Close. Closing then may still save the page, so check Pending imports before you share it again.
If the answer gets lost on the way back, the sheet says “This may have saved. Check Pending imports. Trying again now won’t save it twice.” Tap Try Again or Done.
If the sheet says “Open mirepoix once to reconnect,” open the app, then share again. It happens after you tap Reset bookmarklet in Settings, or when you’ve left the kitchen it was saving to since you last opened the app.

Apple Watch

The watch app comes with the iPhone app and shows your grocery list on your wrist. It works through your iPhone: the watch shows the list your iPhone last sent it, and your iPhone does the checking off and adding.

See what’s left. Open mirepoix on your watch for the count at the top, the items grouped by aisle, each with its amount when it has one, and when the list was last updated. With your iPhone nearby, opening the watch app asks it for a fresh copy, even when the app isn’t open there. The watch asks again about every 30 seconds while it stays open. Changes made anywhere show up that way. A list more than 12 hours old dims.
Check items off. Tap an item to check it off. It stays in place, crossed out, with Undo below it for a few seconds. Your iPhone records it even when the app isn’t open there.
Add an item. Tap +, then dictate, scribble, or type the item, and tap Add. The top of the list says how each add went, such as “Added milk”. Your iPhone adds it even when the app isn’t open there.
When your iPhone has no signal, it matters whether the app is open there. With the app open on your iPhone, a check-off or an add waits and goes through once your iPhone can reach your kitchen again: the item says Will sync, or the top of the list says “Saved milk. It’ll sync.” When the app isn’t open on your iPhone, nothing waits: the check-off or add doesn’t go through, and the watch says “Your iPhone is offline. Try again.”
Away from your iPhone, the watch keeps showing the last list it got and says Phone not nearby. You can check off and add again once your iPhone is back in reach.
Put the count on your watch face. The Groceries complication comes in four shapes: a rectangle with the count and the next 2 items, a circle with the count, a corner with the count, and one inline line. It works in the Smart Stack too. Once the list is more than 12 hours old, the complication dims and shows a dash in place of the count.
It wears your palette. The watch app takes the Palette you chose on your Account page, Mirepoix or Catppuccin, in its dark colors. A change reaches the watch within about 30 seconds while the watch app is open, your iPhone is nearby, and the app is open on your iPhone.

Signing out of the app on your iPhone clears the list from your watch, which then says Sign in to mirepoix on your iPhone.

Also in the app

A search button in the tab bar. On iOS 18 or later, the tab bar ends with a search button that opens search on the page you’re on.
Fresher lists for shopping without a signal. With Background App Refresh on, the app reloads Groceries and Menu from time to time in the background, so the copies you read without a signal are recent. iOS decides when that happens. With Add with Siri through Reminders on, the same refresh also moves items from your Reminders list.