A pantry-first recipe finder.
Add what's actually in your kitchen, and find real recipes you can cook right now, no grocery run required.
- Real accounts. Passwords hashed with bcrypt, sessions signed with JWT. Your pantry and favorites are yours alone, every route checks ownership before returning anything.
- A running pantry list. Add ingredients as you think of them, remove what you've used up.
- Recipe matching. Search ranks results by how many of your ingredients each recipe actually uses, and tells you exactly what you're missing.
- Works immediately, no API key required. Ships with a built-in set of 15 recipes and a real matching algorithm, so it's fully functional the moment you download it.
- Upgrades to live search automatically. Add a free
Spoonacular API key
(150 requests/day free) to
backend/.envand the app switches from the built-in dataset to real, live recipe search, no code changes needed. - Favorites, saved per account, ready to revisit any time.
- Create an account on the auth section (scroll down from the hero, or click "Start cooking").
- Add ingredients to your pantry, one at a time.
- Press Find recipes. Results are ranked by how many of your ingredients each one uses.
- Click a recipe to see the full ingredient list and instructions.
- Save to favorites to keep it for later.
- The built-in recipe set is 15 recipes, enough to see the matching logic work well with common staples (egg, rice, garlic, onion, tomato, etc.), but it's not a full recipe database, that's what the optional Spoonacular integration is for.
- No "forgot password" flow, since no mail server is set up.
- SQLite is a single file on disk, make sure wherever you deploy this keeps it on persistent storage.
Released under the MIT License. You're free to use, modify, and share this code, just keep the original copyright notice attached.