# Beans

> Household recipe app: cookable cards, freezer, week, grocery

Beans is a phone-first household recipe kitchen. Paste a recipe link or screenshot in chat; Beans saves ingredients and steps in one layout. It never invents ingredients. Recipes are shared; freezer, this week, grocery, and chat stay on each login.

## For AI agents

- Public docs: https://www.stovfam.com/llms.txt (this file), https://www.stovfam.com/llms-full.txt, https://www.stovfam.com/ai, https://www.stovfam.com/about, https://www.stovfam.com/openapi.json
- Machine card: https://www.stovfam.com/.well-known/agent.json
- Sitemap: https://www.stovfam.com/sitemap.xml
- Sign in (humans and agents with household permission): https://www.stovfam.com/login
- Do not scrape /chat, /recipes, /freezer, /week, /grocery, or /account without a valid session cookie. Those are a private family kitchen.

## How to use (authenticated)

1. GET https://www.stovfam.com/login
2. POST the login form: email (optional; blank = household), password, button "Open Beans"
3. Session cookie: beans_session (HttpOnly)
4. Then use Chat to add a recipe URL, or open Ideas to pick a public web recipe and save the original page as a card.
5. Beans extracts ingredients and steps from the source. If it cannot read the source, it does not save a made-up recipe.

## Contact

Family site: Stovfam. Tester admin notify inbox is configured on the server (not listed here).


## Product facts

- Phone-first. Add to Home Screen.
- Default folders: Dinner, Breakfast, Salads, Soups, Sides, Dessert, Bread, Preserving, Appetizers, Cocktails
- Ideas tab: mood questions + 100 web recipes per folder. Picking one extracts the original page into the shared library.
- Admin Account (household or tester admin): approve list requests, dashboard (recipe counts, people using Beans)

## Accessibility for agents

Login fields: #email, #password, button name "Open Beans"
Chat: #chat-text, button name "Send"
Ideas: GET /suggestions?craving=&protein=&time=&folder=