Connect your household

Paste your Supabase project URL and anon (public) key from Project Settings, API. They're saved on this device only.

Project URL Anon key

Sign in

Email Password

New here?

Necessities

Choose a new password

You've been invited to a household on Necessities. Pick a password so you can sign in next time.

New password Type it again

Necessities

↓ Pull to refresh

In the house

Add item

Item Brand

Variety The kind you have now. Kinds you've bought before stay in the list.

Kind Status

Where it lives Category

How many

Size of one

Use by / best before Bought on

Lasts about (days) Notes

Where to buy

Usual store If it's out of stock

Product link at that store Paste the product's amazon.com page, for Whole Foods too. Short a.co links won't work.

Staple: always keep in stock (adds itself to the shopping list when it runs low)

Add meal

From a recipe Meal

Day Meal time

Ingredients Recipe link Who it's for Open recipe ↗ Notes

Add recipe

Recipe name Ingredients Method

Hands-on min Serves Tags

Recipe link Open recipe ↗ Cook again

How was it?

Note (optional)

Order

Status

Store Order number

Arrives from Arrives byLeave empty if it's one day.

Carrier Tracking number

Tracking link Order page link

Total paid Placed by

Notes

Bought it?

Tell me how, so the app knows whether it's here yet.

Where to buy?

Always buy this here

Edit

How many? A number, or a size like "2 lb" or "3 bunches".

Add person

Name Role Notes

Delete for good?

This can't be undone. It deletes:

Everything in the house, shopping, family, meals and orders
Family members' allergies, sizes and preferences
Pending invites and every connected assistant key

Type to confirm Capitals don't matter.

Settings

Household

Time zone Reminders arrive in the morning here, not the middle of the night.

Invite by email

Invite a partner, a nanny, anyone who shops or cooks with you.

No email? They can make an account and enter this code instead:

Meal plan

Week starts on Pick the day you usually plan, so This week runs from then. The assistant plans the same way.

Shopping

How far back to look Used when your stores connect, to fill your house. Usual store The family default for everything. To send one item somewhere else, open that item in In the house and use Where to buy.

If something's out of stock

Who places the order

Spending limit for the assistant ($) Only used by the middle choice. Above this, the assistant fills the cart and asks you.

Stores we shop at

Connected assistants

Give an assistant like Instinct or ChatGPT its own key. Paste it in once and it stays connected until you turn it off here. It sees and changes the household as you.

Assistant name

Key for

Copy it now. For safety it won't be shown again; if you lose it, just make a new one.

Connector address The address has no key in it. Never add the key to the address: it won't work. Key Paste this where your assistant asks for an API key, token or header. If it asks for a header name, use X-Necessities-Key.

Import from your pantry sheet

In Google Sheets, choose File, Download, CSV. Columns it reads: Location, Category, Item, Brand, Amount, Expiry / Notes, Status, Date Added. Import each sheet once.

Import as CSV file

Your household's data

Everything your household has saved: the house, shopping, family (including allergies and sizes), meals, orders, stores and settings, and the email of everyone in the household. Keys for connected assistants are left out. Anyone in the household can download this.