# Spoonjoy

> Spoonjoy is a recipe app for home cooks: recipes as steps you can cook from, cookbooks, a shopping list grouped by aisle, and an API and MCP server for agents. Its screens are built from Ouro HX components (v1.2.13), and the code is open: it is the reference for building an app with Ouro HX.

## Try it

- [Test Kitchen](https://spoonjoy.app/test-kitchen): cook a recipe without an account, and add ?xray to outline the Ouro HX components on the page, with links to their docs and source

## Build with it

- [Source](https://github.com/spoonjoy/spoonjoy-v2): React Router on Cloudflare Workers
- [Building with Ouro HX](https://github.com/spoonjoy/spoonjoy-v2/blob/main/docs/building-with-ouro-hx.md): how Spoonjoy installs, themes and composes Ouro HX, and what to do when HX lacks a component
- [Ouro HX provenance](https://spoonjoy.app/ouro-provenance.json): the Ouro HX release and, page by page, the files a page is built from and the HX components they render
- [Ouro HX](https://ui.ouro.bot/): the component library

## Use it from an agent

- [Developers](https://spoonjoy.app/developers): the API, OAuth and MCP in one place
- [API docs](https://spoonjoy.app/api/docs): the REST API reference
- [MCP](https://spoonjoy.app/mcp): connect an agent to a Spoonjoy account