generated from chingu-voyages/voyage-template
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs(readme): add project-specific README for YumYumYes!
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
Showing
2 changed files
with
170 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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? | ||
--> |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.