Settings

Tap mirepoix in the navigation bar, then choose Kitchen Settings.

Settings holds the configuration for the kitchen you’re viewing. Your own name, email, passkeys, and sign-ins live on the Account page instead — tap mirepoix, then the person icon at the top right of the menu.

Changes save as you make them — there’s no Save button. Toggles save the moment you flip them. Text fields save shortly after you stop typing, and right away if you click away mid-edit. A small spinner beside the field shows while a change is saving, then Saved ✓ confirms it and fades away after a moment.

Site, Recipes, Cooking preferences, Visibility, and Handle are owner-only. Members who aren’t owners see Settings without those sections.

Site

Site title — the browser tab title and the app’s name across pages.

Recipes

Display nutrition information under recipes — when on, recipes with enough catalog data show an FDA-style nutrition label below the recipe. See Nutrition for details.

Ingredient lines — choose how ingredient lines read on recipe pages: Name first — “Sugar, 1 cup” or Amount first — “1 cup Sugar”. New kitchens start on Name first. The choice changes how lines appear on the recipe page, on-screen and in print, and which box comes first in each ingredient row of the recipe editor. The recipe’s own text, anything you export, and your kitchen’s feed always keep the name-first form.

Cooking preferences

What your kitchen cooks for and around. Mirabel uses these when she suggests or drafts — they never limit search. Three controls:

Usually cooking for — how many people you normally cook for, a number from 1 to 99. Leave it empty if you’d rather not say.

Diets — checkboxes for the diets your kitchen follows: vegetarian, vegan, pescatarian, gluten-free, dairy-free, kosher, and halal. That’s the whole list — you can’t add your own. Check as many as apply.

Avoid — ingredients this kitchen skips. Type one in the box and tap Add, or press Enter. As you type, matching ingredient names from the shared catalog are offered as you go, so a chip can use the same name your recipes do. Remove a chip with its ×. You can keep up to 20, each up to 40 characters.

These preferences go to Mirabel and nowhere else. They shape what she suggests and drafts — nothing here filters, hides, or reorders recipes anywhere in Mirepoix. Every recipe in your kitchen stays findable, including recipes that use an ingredient you’ve listed. Mirepoix has no allergy setting and doesn’t screen recipes for allergens, so read a recipe’s ingredients yourself when it matters to someone’s health.

Visibility

Publish recipes — when checked, your recipes are publicly accessible and may be indexed by search engines. When unchecked, only signed-in members can view the kitchen.

Publishing also makes the kitchen’s Atom feed at /feed publicly accessible. (Members can still subscribe even when the kitchen is unpublished.) Feed readers pointed at any kitchen URL will auto-discover it, so subscribers see new and updated recipes as you add them.

Data

Export All Data — downloads a ZIP of your recipes, photos, catalog, and kitchen settings. Available to every member. See Export for what the archive holds.

Importing recipes

Shows only when the deployment has an Anthropic API key configured, so Mirabel is available.

An Import to mirepoix button you drag to your browser’s bookmarks bar. Use it on recipe pages Mirepoix can’t open itself — anything behind a login or paywall.

If your bookmarks bar is tight on space, check Compact button label (for narrow bookmark bars) beneath the button before you drag. The button’s text becomes ↓mp, so the bookmark you drag takes that short name instead. Only the name changes — the bookmark saves recipes exactly the same way. And it’s a choice you make at drag time, not a saved preference. The box starts unchecked every time the page loads, and dragging again with it unchecked gives you a bookmark named Import to mirepoix again.

To install it, drag the button up to your bookmarks bar. Then, on a recipe page, click the saved bookmark. It saves the page to mirepoix quietly, in the background — a small confirmation appears in the corner with an Open link, and you don’t need to switch tabs right away.

The recipe waits for you under Pending Imports, a button of its own at the top of your recipes list. Tap the entry when you’re ready, and Mirabel opens with a confirm card naming the page it came from — Import a recipe from example.com? Tap Import to build a draft, or Dismiss to cancel — nothing is imported until you tap Import. A recipe you neither import nor dismiss clears itself after 30 days.

Setting up the bookmarklet and saving a recipe to import later.

Scroll horizontally to see the full flow. In Settings, drag Import to mirepoix to your bookmarks bar once. On a recipe page, click it to save the capture quietly. Open it from the confirmation or Pending Imports later; Mirabel asks before importing anything.

Some sites block the background save. There, clicking the bookmark opens Mirabel right away with the recipe it read, the way the bookmarklet has always worked — confirm the import the same way, with Import or Dismiss.

If you think your bookmarklet button has been shared or copied somewhere you didn’t intend, tap Reset bookmarklet below the button. It stops any copy you’ve already dragged from saving in the background — those fall back to opening Mirabel directly, the same as a blocked site — until you drag the fresh one it gives you.

On a phone there’s a way in that needs no bookmark at all — share a page to Mirepoix from the system Share sheet.

Members

The Members subsection shows everyone in the kitchen, with role badges (owner / member). Owners see controls to invite new members, revoke pending invitations, and promote/demote roles. See Inviting members for the full workflow.

This device

Holds Log in on another device — opens a dialog with a short-lived QR code you can scan from a phone or tablet to sign in without typing. Close the dialog with its ×, the Escape key, or by clicking outside it. The code expires in 5 minutes.

Handle

Owner-only. Your kitchen’s web address — the /@your-handle part of every link to it.

Type a new handle and tap Change handle. Old links keep redirecting to the new address. The handle you leave behind stays reserved to your kitchen — no one else can take it, and you can switch back to it later if you want. You can change your handle once every 30 days.

API keys

Mirepoix takes one API key, an Anthropic key. It turns on the abilities that need AI — Mirabel’s chat answers, importing a recipe from a photo, and browser captures like the Import to mirepoix bookmarklet above. The rest of the app works without it, including Mirabel’s guided add-a-recipe interview and USDA nutrition search.

The key is deployment-level configuration. It isn’t stored in the database and can’t be changed here.

Hosted installs: the operator sets the key, so the abilities that need it are already on.
Homelab installs: set ANTHROPIC_API_KEY in your docker-compose.yml environment section or .env file. See .env.example and docker-compose.example.yml for the other variables you can set.

The key applies to every kitchen on the deployment.

Danger zone

The Danger zone groups the kitchen-level actions kept apart from everyday settings:

Leave $kitchen — leave the kitchen you’re currently viewing. See Leaving a kitchen.
Delete $kitchen — owners only; permanently removes the kitchen and all its content. See Deleting a kitchen.

Deleting your account and signing out of other devices moved to the Account page.

To sign out, tap mirepoix in the navigation bar and choose Sign out. See Signing in for how it works.