missating / More-Recipes

More-Recipes provides a platform for users to share awesome and exciting recipe ideas

Home Page:https://nkoyo-more-recipes.herokuapp.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build Status Coverage Status Maintainability codecov

More-Recipes

More-Recipes is a full stack web application that provides a platform for users to share their awesome and exciting recipe ideas they have invented or learnt.

Technologies


  1. Nodejs
  2. Postgresql
  3. Express
  4. Sequelize
  5. React
  6. Redux

API Documentation


The full documentation for all API end point can be found here

Functionalities


Users are grouped into 2 categories:

Non Registered Users:

  • Create an account (Sign up)
  • View Featured Recipes
  • View all Recipes
  • View a single Recipe
  • Search for a Recipe

Registered Users:

  • Sign in as a user
  • Create Recipe
  • Update created Recipes
  • Delete Created Recipes
  • Upvote a Recipe
  • Downvote a Recipe
  • Add a recipe as Favourite
  • View all created Recipe
  • View all favourited Recipe
  • Remove upvote on a Recipe
  • Remove downvote on a Recipe
  • Remove Recipe from favourite
  • Add Review for a Recipe
  • View Profile
  • Update Profile
  • View Featured Recipes
  • View all Recipes
  • View a single Recipe
  • Search for a Recipe

Limitations


This project has some Limitations. The most notable ones are:

  1. Users cannot view other user's profile
  2. Users cannot view other user's favourited recipes or created recipes
  3. Users cannot change their password or reset password if forgotten
  4. Users cannot deactivate their account

How to Install


  1. Clone the repository and change directory into the folder

git clone https://github.com/missating/More-Recipes.git && cd more-recipes

  1. Install project dependencies

npm install

  1. Create a .env file and copy comtent of .env.sample to it and provide the appropraite values

  2. Look at this file config.json and read this to setup postgres/sequelize to create a Database then run migration

npm run migration

  1. Then start the server

npm run start:dev

  1. Navigate to your browser to view the app on http://localhost:3000

Demo


View the application here

Test


The application uses the following for Testing:

  • Backend Test npm run test:server

  • FrontEnd Test npm run test:client

FAQ


  • What language was used to develop this application ?

This is a fullstack Javascript application with client side in React/Redux

  • Who can contribute ?

Anyone

Author


Nkoyo Ating miss__ating

License


This is licensed for your use, modification and distribution under the MIT LICENSE

About

More-Recipes provides a platform for users to share awesome and exciting recipe ideas

https://nkoyo-more-recipes.herokuapp.com/

License:MIT License


Languages

Language:JavaScript 82.7%Language:HTML 14.6%Language:CSS 2.7%