Skip to content

Commit 7069e63

Browse files
committed
Update readme and images
1 parent 8a19461 commit 7069e63

12 files changed

Lines changed: 95 additions & 0 deletions

README.md

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
# Recipe For Success
2+
3+
No idea what to cook? No worries! The Recipe For Success app does the thinking for you.
4+
5+
## Table of Contents
6+
7+
- [Description](#description)
8+
- [Features](#features)
9+
- [Technologies Used](#technologies-used)
10+
- [Installation](#installation)
11+
- [Usage](#usage)
12+
- [Screenshots](#screenshots)
13+
- [Contributors](#contributors)
14+
- [Acknowledgements](#acknowledgements)
15+
16+
## Description
17+
18+
Recipe For Success is a web application that generates personalized recipes based on user preferences and dietary restrictions. Utilizing the OpenAI API for text and image generation, this app provides unique recipes complete with AI-generated images.
19+
20+
The application is hosted on Vercel and can be accessed at [Recipe For Success](https://recipe-for-success-iota.vercel.app/).
21+
22+
## Features
23+
24+
- **Cuisine Selection**: Choose from Italian, Chinese, Peruvian, or Random.
25+
- **Dietary Requirements**: Specify if you are lactose intolerant, vegan, or list specific foods you don't eat.
26+
- **Dark/Light Mode**: Toggle between dark and light themes.
27+
- **Loading Indicator**: Displays a loading message while generating your recipe.
28+
- **Recipe Display**: Shows the recipe along with an AI-generated image.
29+
- **Text-to-Speech**: Have the recipe read out loud for accessibility.
30+
- **Email Recipe**: Send the recipe to your email.
31+
- **New Recipe Button**: Easily request another recipe.
32+
33+
## Technologies Used
34+
35+
- **Frontend**: HTML, CSS, JavaScript
36+
- **Backend**: Node.js, Express
37+
- **API**: OpenAI API for text and image generation
38+
- **Accessibility**: Text-to-Speech
39+
- **Other**: Email integration, Dark/Light mode toggle
40+
- **Hosting**: Vercel
41+
42+
## Installation
43+
44+
### Install Dependencies
45+
46+
```sh
47+
npm install dotenv express node nodemailer openai type nodemon
48+
49+
50+
51+
### Setup Environment Variables
52+
53+
Create a `.env` file in the root directory and add your OpenAI API key and other necessary configurations.
54+
55+
### Run the Application
56+
57+
## Usage
58+
59+
Open the application in your browser.
60+
Select your desired cuisine (Italian, Chinese, Peruvian, or Random).
61+
Indicate any dietary requirements (lactose intolerant, vegan, or specify other restrictions).
62+
Click the button and wait for the recipe to be generated.
63+
View the recipe along with an AI-generated image.
64+
Use the text-to-speech feature to hear the recipe.
65+
Email the recipe to yourself or request a new recipe.
66+
67+
## Screenshots
68+
69+
- Home Screen
70+
![Home Screen](public/image/Screenshot 2024-05-18 at 08.19.25.png)
71+
- Dietary Requirements
72+
![Dietary Requirements](public/image/dietary.png)
73+
- Specify Other Dietary Requirements
74+
![Specify Other Dietart Requirements](public/image/other.png)
75+
- Toggle Dark Mode
76+
![Toggle Dark Mode](public/image/darkmode.png)
77+
- Loading Indicator
78+
![Loading Indicator](public/image/loading.png)
79+
- Recipe Result
80+
![Recipe Result](public/image/recipe.png)
81+
- Email Recipe
82+
![Email Recipe](public/image/email.png)
83+
84+
## Contributors
85+
86+
- Sam Hill
87+
- Josue
88+
89+
## Acknowledgements
90+
91+
Thanks to OpenAI for their API.
92+
Inspiration from various cooking apps.
93+
Special thanks to Founders and Coders for providing the basic knowledge to pursue the project.
94+
Special thanks to everyone who helped with the project.
95+
```
1.51 MB
Loading
1.28 MB
Loading
3.84 KB
Loading

public/image/darklightbutton.png

15 KB
Loading

public/image/darkmode.png

793 KB
Loading

public/image/dietary.png

110 KB
Loading

public/image/email.png

115 KB
Loading

public/image/loading.png

411 KB
Loading

public/image/other.png

34.1 KB
Loading

0 commit comments

Comments
 (0)