Skip to content

Commit

Permalink
docs(readme): add project-specific README for YumYumYes!
Browse files Browse the repository at this point in the history
This readme contextualizes YumYumYes! for interested parties, be the colleagues or prospective
employers or clients. The document is useful as-is, but there is much more that could be done here.
I've commented out several sections as "In Progress".
  • Loading branch information
joekotvas committed Oct 22, 2023
1 parent 658874c commit 589a18d
Show file tree
Hide file tree
Showing 2 changed files with 170 additions and 5 deletions.
175 changes: 170 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,173 @@
# React + Vite
<img src="src/assets/brand/yumyumyes-logo-m.png" style="max-width:300px;" />

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
# YumYumYes.com - Recipe Search Web App

Currently, two official plugins are available:
YumYumYes! is a beautiful, full-featured, responsive web app that interfaces with the [Tasty API](https://rapidapi.com/apidojo/api/tasty) and allows users to search, view and save recipes. It was built from the ground up for [Chingu Voyage 46](https://github.com/chingu-voyages/voyage-project-tier2-recipes).

- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh
## Table of contents

- [Overview](#overview)
- [About Chingu](#about-chingu)
- [Basic Requirements](#basic-requirements)
- [Our Solution](#our-solution)
- [Concept](#concept)
- [Screenshots](#screenshots)
- [Links](#links)

<!-->

- [Details](#my-process)
- [Organization](#organization)
- [Tools & Libraries](#built-with)
- [Design](#design)
- [What we Learned](#what-we-learned)
- [Continued Development](#continued-development)
- [Useful Resources](#useful-resources)
- [Authors](#authors)
- [Acknowledgments](#acknowledgments)
-->

## Overview

### The challenge

#### About Chingu:

Chingu is a community of developers who are passionate about learning, helping others, and collaborating on projects. It is a remote, self-organizing, project-based learning platform. Chingu helps you to build your portfolio and network while collaborating on real-world projects with remote team members. "Chingus" are motivated learners who are self-directed and take responsibility for their own learning.

#### Basic requirements:

> Use the Tasty API to create an app that will help anyone interested in creating dishes and flavours to explore recipes in novel ways.
**Landing Page**

_User can see a landing page containing at least the following components:_

- [ ] Header component displaying a welcome message.
- [ ] Search field that enables users to input ingredient(s).
- [ ] Component to explain the use of the application.
- [ ] A scrollable list of recipes displaying the results based on the search criteria. Keep in mind that the Recipe API has over 1500 Recipes, however, it's paginated with 20 recipes per page of result.
- [ ] A summary main recipe component: it should display recipe image, name and link to details.
- [ ] A summary detail recipe component: it should display recipe name, category, and instructions.
- [ ] Ensure mobile responsiveness for the application.

**Search Component**

_Users can input one or multiple ingredient(s)._

- [ ] Initiate the search by either pressing the Enter key or clicking the 'Search' button/icon.
- [ ] Display an error message when an unlisted item is entered.

**Main Data Display Component**

- [ ] Display results for each recipe in the main component.
- [ ] Remain on the landing page if no search ingredient has been entered.

**Summary Detail Component**

_Display the following information of the selected recipe:_

- [ ] Name
- [ ] Category
- [ ] List of instruction
- [ ] List of nutrition
- [ ] Add a Link to the instruction video

## Our Solution

### Concept

We developed a unique web app with a distinctive brand and a whimsical, animated design. YumYumYes! is intended to make recipe browsing fun! Colorful mascots Yumi and Chef Carrots welcome visitors to our pages, and delightful visual motifs including text gradients, 3d colored balls, dashed lines and gentle curves are intended to make the app feel more alive and engaging.

YumYumYes! allows users to search for recipes by ingredient and filter by useful tags such as difficulty, occasion, etc. The app also allows users to save recipes to their favorites list, and to view their favorites list at any time.

The app is built as a fully responsive web app compatible with all modern web browsers, both mobile and desktop. We've taken care to make it intuitive for all users, and accessible to users with different abilities.

### Screenshots

<div style="display:flex;gap:1rem;flex-wrap:wrap;">
<div style="flex:1;min-width: 200px;">
<em>Home Page</em>
<a href="public/screenshots/screenshot-home-dev.png">
<img src="public/screenshots/screenshot-home-dev.png" alt="Home Page">
</a>
</div>
<!--
<div style="flex:1;min-width: 200px;">
<em>Home Page</em>
<a href="public/screenshots/screenshot-home-dev.png">
<img src="public/screenshots/screenshot-home-dev.png" alt="Home Page">
</a>
</div>
<div style="flex:1;min-width: 200px;">
<em>Home Page</em>
<a href="public/screenshots/screenshot-home-dev.png">
<img src="public/screenshots/screenshot-home-dev.png" alt="Home Page">
</a>
</div>
<div style="flex:1;min-width: 200px;">
<em>Home Page</em>
<a href="public/screenshots/screenshot-home-dev.png">
<img src="public/screenshots/screenshot-home-dev.png" alt="Home Page">
</a>
</div>
-->
</div>

### Links

- Live Site URL: [YumYumYes.com](https://yumyumyes.com)
- Source Code: [Github Repository](https://github.com/chingu-voyages/v46-tier2-team-19)
- Design Mockup: [YumYumYes Figma Mockup](https://www.figma.com/file/CbJFJOPY0r5EbEpRSNrx9b/YumYumYes-wireframe)
<!-->

## Our Process

### Tools & Libraries

- Semantic HTML5 markup
- Flexbox
- Mobile-first workflow
- [Tailwind](https://tailwindcss.com/) Tailwind CSS
- [React](https://reactjs.org/) - JS library
- [Vite](https://vitejs.dev/) - React framework
- [React Router](https://reactrouter.com/) - Routing
- [React Query](https://react-query.tanstack.com/) - Data fetching

### What We Learned

We can use this section recap some of our primary takeaways from this project. We might write as a group, or we might add sections for each author.

```html
<h1>Some HTML code I'm proud of</h1>
```

```css
.proud-of-this-css {
color: papayawhip;
}
```

```js
const proudOfThisFunc = () => {
console.log("🎉");
};
```

### Continued development

We can use this section to outline areas that we want to continue focusing on in future projects. These could be concepts we're still not completely comfortable with or techniques we found useful that you want to refine and perfect.

### Useful resources

- [Example resource 1](https://www.example.com) - This helped me for XYZ reason. I really liked this pattern and will use it going forward.
- [Example resource 2](https://www.example.com) - This is an amazing article which helped me finally understand XYZ. I'd recommend it to anyone still learning this concept.

## Authors

**[Joseph Kotvas](https://www.josephkotvas.com)**

## Acknowledgments

Here goes the shoutout to to Jim Medlock, Robestar, and all the other Chingus who have helped make this possible. Possibly others as well?
-->
Binary file added public/screenshots/screenshot-home-dev.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 589a18d

Please sign in to comment.