Settings

Tap mirepoix in the navigation bar, then choose 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 Account.

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, 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.

Homepage heading — the large heading on the Recipes homepage.

Homepage subtitle — a line of smaller text beneath the heading.

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 only changes how lines appear on the recipe page, on-screen and in print. The recipe’s own text, anything you export, and your kitchen’s feed always keep the name-first form.

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.

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.

To install it, drag the button up to your bookmarks bar. Then, on a recipe page, click the saved bookmark: it reads that page’s recipe and opens your recipes, where Mirabel shows a confirm card. Tap Import to build a draft, or Dismiss to cancel — nothing is sent until you tap Import.

In Settings, drag the Import to mirepoix button to your bookmarks bar once. Later, on a recipe page Mirepoix can’t open itself, click that saved bookmark. It sends the page to Mirabel, who opens your recipes and asks to confirm — nothing is imported until you tap Import.

Some sites block bookmarklets. If clicking does nothing, copy the recipe text and paste it to Mirabel instead. See Mirabel for the chat side.

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 — generates a short-lived QR code you can scan from a phone or tablet to sign in without typing. 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.

Last updated July 14, 2026