nvm install 16
nvm use 16
npm install
Este é app de receitas, utilizando o que há de mais moderno dentro do ecossistema React: Hooks e Context API!
Nele é possível: ver, buscar, filtrar, favoritar e acompanhar o progresso de preparação de receitas de comidas e bebidas!
O layout tem como foco dispositivos móveis, dessa forma todos os protótipos vão estar desenvolvidos em telas menores.
Nesse projeto, fui capaz de:
- Utilizar Redux para gerenciar estado
- Utilizar a biblioteca React-Redux
- Utilizar a Context API do React para gerenciar estado
- Utilizar o React Hook useState
- Utilizar o React Hook useContext
- Utilizar o React Hook useEffect
- Criar Hooks customizados
- Utilizar resolução de tela de
360 x 640
(360 pixels de largura por 640 pixels de altura).
É possível verificar o percentual da cobertura de testes com o comando npm run test-coverage
.
Você também pode executar npm run test-coverage -- --collectCoverageFrom=caminho/da/Pagina
para verificar o percentual de cobertura de testes de cada 'Pagina'. Por exemplo, para verificar a cobertura de testes da página de Login
, execute o comando npm run test-coverage -- --collectCoverageFrom=src/pages/Login.js
.
-
APIs
-
TheMealDB API
O TheMealDB é um banco de dados aberto, mantido pela comunidade, com receitas e ingredientes de todo o mundo.
Os end-points são bastante ricos, você pode vê-los aqui
O modelo de resposta para uma
meal
é o seguinte:Ver modelo de resposta para uma meal
{ "meals":[ { "idMeal":"52882", "strMeal":"Three Fish Pie", "strDrinkAlternate":null, "strCategory":"Seafood", "strArea":"British", "strInstructions":"Preheat the oven to 200C\/400F\/Gas 6 (180C fan).\r\nPut the potatoes into a saucepan of cold salted water. Bring up to the boil and simmer until completely tender. Drain well and then mash with the butter and milk. Add pepper and taste to check the seasoning. Add salt and more pepper if necessary.\r\nFor the fish filling, melt the butter in a saucepan, add the leeks and stir over the heat. Cover with a lid and simmer gently for 10 minutes, or until soft. Measure the flour into a small bowl. Add the wine and whisk together until smooth.\r\nAdd the milk to the leeks, bring to the boil and then add the wine mixture. Stir briskly until thickened. Season and add the parsley and fish. Stir over the heat for two minutes, then spoon into an ovenproof casserole. Scatter over the eggs. Allow to cool until firm.\r\nSpoon the mashed potatoes over the fish mixture and mark with a fork. Sprinkle with cheese.\r\nBake for 30-40 minutes, or until lightly golden-brown on top and bubbling around the edges.", "strMealThumb":"https:\/\/www.themealdb.com\/images\/media\/meals\/spswqs1511558697.jpg", "strTags":"Fish,Seafood,Dairy,Pie", "strYoutube":"https:\/\/www.youtube.com\/watch?v=Ds1Jb8H5Sg8", "strIngredient1":"Potatoes", "strIngredient2":"Butter", "strIngredient3":"Milk", "strIngredient4":"Gruy\u00e8re", "strIngredient5":"Butter", "strIngredient6":"Leek", "strIngredient7":"Plain Flour", "strIngredient8":"White Wine", "strIngredient9":"Milk", "strIngredient10":"Parsley", "strIngredient11":"Salmon", "strIngredient12":"Haddock", "strIngredient13":"Smoked Haddock", "strIngredient14":"Eggs", "strIngredient15":"", "strIngredient16":"", "strIngredient17":"", "strIngredient18":"", "strIngredient19":"", "strIngredient20":"", "strMeasure1":"1kg", "strMeasure2":"Knob", "strMeasure3":"Dash", "strMeasure4":"50g", "strMeasure5":"75g", "strMeasure6":"2 sliced", "strMeasure7":"75g", "strMeasure8":"150ml", "strMeasure9":"568ml", "strMeasure10":"2 tbs chopped", "strMeasure11":"250g", "strMeasure12":"250g", "strMeasure13":"250g", "strMeasure14":"6", "strMeasure15":"", "strMeasure16":"", "strMeasure17":"", "strMeasure18":"", "strMeasure19":"", "strMeasure20":"", "strSource":"https:\/\/www.bbc.co.uk\/food\/recipes\/three_fish_pie_58875", "dateModified":null } ] }
Os ingredientes seguem uma ordem lógica onde o nome dele (
strIngredient1
) e a quantidade (strMeasure1
) tem o mesmo número no final (1, nesse caso).É possível listar todas as
categorias
,nacionalidades
(vindas da API como "areas") eingredientes
:categorias: https://www.themealdb.com/api/json/v1/1/list.php?c=list nacionalidades: https://www.themealdb.com/api/json/v1/1/list.php?a=list ingredientes: https://www.themealdb.com/api/json/v1/1/list.php?i=list
As fotos dos ingredientes vêm de um end-point padronizado com a seguinte lógica:
https://www.themealdb.com/images/ingredients/{nome-do-ingrediente}-Small.png // exemplo com "Lime" https://www.themealdb.com/images/ingredients/Lime-Small.png
-
The CockTailDB API
Bem similar (inclusive mantida pela mesma entidade) a TheMealDB API, só que focado em bebidas.Os end-points também são bastante ricos, você pode vê-los aqui
As respostas seguem a mesma estrutura, com algumas particularidades relativas às bebidas (como ser ou não alcoólica, por exemplo)
Os ingredientes seguem uma ordem lógica onde o nome dele (Ver modelo de resposta para drinks
{ "drinks":[ { "idDrink":"17256", "strDrink":"Martinez 2", "strDrinkAlternate":null, "strDrinkES":null, "strDrinkDE":null, "strDrinkFR":null, "strDrinkZH-HANS":null, "strDrinkZH-HANT":null, "strTags":null, "strVideo":null, "strCategory":"Cocktail", "strIBA":null, "strAlcoholic":"Alcoholic", "strGlass":"Cocktail glass", "strInstructions":"Add all ingredients to a mixing glass and fill with ice.\r\n\r\nStir until chilled, and strain into a chilled coupe glass.", "strInstructionsES":null, "strInstructionsDE":"Alle Zutaten in ein Mischglas geben und mit Eis f\u00fcllen. Bis zum Abk\u00fchlen umr\u00fchren und in ein gek\u00fchltes Coup\u00e9glas abseihen.", "strInstructionsFR":null, "strInstructionsZH-HANS":null, "strInstructionsZH-HANT":null, "strDrinkThumb":"https:\/\/www.thecocktaildb.com\/images\/media\/drink\/fs6kiq1513708455.jpg", "strIngredient1":"Gin", "strIngredient2":"Sweet Vermouth", "strIngredient3":"Maraschino Liqueur", "strIngredient4":"Angostura Bitters", "strIngredient5":null, "strIngredient6":null, "strIngredient7":null, "strIngredient8":null, "strIngredient9":null, "strIngredient10":null, "strIngredient11":null, "strIngredient12":null, "strIngredient13":null, "strIngredient14":null, "strIngredient15":null, "strMeasure1":"1 1\/2 oz", "strMeasure2":"1 1\/2 oz", "strMeasure3":"1 tsp", "strMeasure4":"2 dashes", "strMeasure5":null, "strMeasure6":null, "strMeasure7":null, "strMeasure8":null, "strMeasure9":null, "strMeasure10":null, "strMeasure11":null, "strMeasure12":null, "strMeasure13":null, "strMeasure14":null, "strMeasure15":null, "strCreativeCommonsConfirmed":"No", "dateModified":"2017-12-19 18:34:15" } ] }
strIngredient1
) e a quantidade (strMeasure1
) tem o mesmo número no final (1, nesse caso).
-
-
Rotas
As rotas a serem utilizadas na aplicação devem ser as seguintes:
- Tela de login:
/
; - Tela principal de receitas de comidas:
/meals
; - Tela principal de receitas de bebidas:
/drinks
; - Tela de detalhes de uma receita de comida:
/meals/:id-da-receita
; - Tela de detalhes de uma receita de bebida:
/drinks/:id-da-receita
; - Tela de receita em progresso de comida:
/meals/:id-da-receita/in-progress
; - Tela de receita em progresso de bebida:
/drinks/:id-da-receita/in-progress
; - Tela de perfil:
/profile
; - Tela de receitas feitas:
/done-recipes
; - Tela de receitas favoritas:
/favorite-recipes
.
- Tela de login:
-
LocalStorage
O uso de
localStorage
é necessário para que as informações não se percam caso a pessoa atualize a página. O correto é usar os valores para iniciar sua store ou seu context.No
localStorage
do navegador:- a chave
user
deve conter a seguinte estrutura:
{ email: email-da-pessoa }
- a chave
doneRecipes
deve conter a seguinte estrutura:
[{ id: id-da-receita, type: meal-ou-drink, nationality: nacionalidade-da-receita-ou-texto-vazio, category: categoria-da-receita-ou-texto-vazio, alcoholicOrNot: alcoholic-ou-non-alcoholic-ou-texto-vazio, name: nome-da-receita, image: imagem-da-receita, doneDate: quando-a-receita-foi-concluida, tags: array-de-tags-da-receita-ou-array-vazio }]
- a chave
favoriteRecipes
deve conter a seguinte estrutura:
[{ id: id-da-receita, type: meal-ou-drink, nationality: nacionalidade-da-receita-ou-texto-vazio, category: categoria-da-receita-ou-texto-vazio, alcoholicOrNot: alcoholic-ou-non-alcoholic-ou-texto-vazio, name: nome-da-receita, image: imagem-da-receita }]
- a chave
inProgressRecipes
deve conter a seguinte estrutura:
{ drinks: { id-da-bebida: [lista-de-ingredientes-utilizados], ... }, meals: { id-da-comida: [lista-de-ingredientes-utilizados], ... } }
Observações técnicas
id-da-bebida
eid-da-comida
representam o ID de uma bebida e comida, respectivamente, e cada item da lista de ingredientes da respectiva receita deve ser representado apenas pelo número do ingrediente no formato numérico.
- a chave
-
Ícones
Os ícones a serem utilizados na aplicação estão disponíveis do diretório
src/image/
. Esses ícones serão utilizados pelos testes da avaliação automatizada, então certifique-se de utilizá-los nos requisitos e de não renomeá-los.Os ícones são:
profileIcon.svg
;searchIcon.svg
;drinkIcon.svg
;mealIcon.svg
;shareIcon.svg
;whiteHeartIcon.svg
;blackHeartIcon.svg
;
-
Biblioteca
clipboard-copy
Para os componentes que contêm a funcionalidade de favoritar comidas ou bebidas, será necessário utilizar a biblioteca
clipboard-copy
para copiar as informações da receita. Essa biblioteca já vem instalada no projeto.Para mais informações, consulte a documentação
-
Biblioteca
Bootstrap
(opcional)Para os grupos que quiserem implementar estilizações no app, recomendamos o uso da lib
Bootstrap
. Ela já vem instalada por padrão neste projeto, bastando apenas implementar nos seus componentes. Por exemplo, caso queira implementar um botão:import Button from 'react-bootstrap/Button'; const MeuComponente = () => ( <Button variant="success"> Botão Verde </Button> ); ...
Para mais informações, consulte a documentação