Fridge Recipe Finder is a web application that helps you find recipes based on the ingredients you have in your fridge. Simply enter the ingredients, and the app will provide you with a list of recipes you can make. Additionally, you can find similar recipes and detailed cooking instructions.
- Ingredient-Based Recipe Search: Enter the ingredients you have, and get recipes that you can make with them.
- Similar Recipes: Find recipes similar to the ones you like.
- Cooking Instructions: Get step-by-step cooking instructions for your chosen recipe.
- Responsive Design: Works on both desktop and mobile devices.
- Frontend: HTML, CSS, Bootstrap, EJS (Embedded JavaScript templates)
- Backend: Node.js, Express.js
- API: Spoonacular API
- Environment Variables: dotenv
- Node.js
- npm (Node Package Manager)
- Spoonacular API Key
-
Clone the repository:
git clone https://github.com/yourusername/fridge-recipe-finder.git cd fridge-recipe-finder
-
Install the dependencies:
npm install
-
Create a
.env
file in the root directory and add your Spoonacular API key:SPOONACULAR_API_KEY=your_api_key_here
-
Start the application:
npm start
-
Open your browser and go to
http://localhost:3000
.
- Home Page: Enter the ingredients you have in the textarea provided and submit the form to get recipes.
- Recipe List: Click on a recipe to get the detailed cooking instructions or find similar recipes.
- Instructions Page: Follow the step-by-step instructions to cook your chosen recipe.
- Similar Recipes: Click on "Get similar recipes" to find recipes similar to the one you're viewing.
fridge-recipe-finder/
├── public/
│ └── css/
│ └── styles.css
├── views/
│ ├── partials/
│ │ ├── head.ejs
│ │ ├── navbar.ejs
│ │ ├── footer.ejs
│ ├── index.ejs
│ ├── instructions.ejs
│ ├── about.ejs
├── .env
├── package.json
├── server.js
└── README.md
GET /
- Home page.POST /getrecipes
- Fetches recipes based on ingredients.GET /getrecipes
- Fetches cooking instructions for a specific recipe.GET /similar
- Fetches similar recipes based on recipe ID.GET /about
- About page.
- Fork the repository.
- Create a new branch (
git checkout -b feature-branch
). - Make your changes.
- Commit your changes (
git commit -am 'Add new feature'
). - Push to the branch (
git push origin feature-branch
). - Open a Pull Request.
This project is licensed under the MIT License. See the LICENSE file for details.
For any questions or suggestions, feel free to open an issue or contact the project maintainers.
Happy cooking! 🍳