Skip to content

Nugget-Reactor/FEC

Repository files navigation

Logo

Gnicchi

Gnicchi is a mock front-end webstore created for our Hack Reactor Front End Capstone Project.

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Meet The Team

About The Project

Screen capture of the homepage


Our team was tasked with creating a mock front-end webstore using a provided black box database. Main features of the website include the product overview section, related products & your outfit section, questions & answers section, and th ratings & reviews section. We go into detail about each of these website features below.

Overview

The main entry point of the page, this section shows the current product, and allows the user to browse through photos of the product, zoom in on the photos, look at the product's different styles, see the prices and description, and add the product to their cart.

Gif of the image gallery in overview widget


The Overview's current product informs all of the other widgets and changes based on the user's selection in the Related Products & "Your Outfit" widget, and the user's selection in the style selector component.

Gif of the style selector in overview widget

The version of the cart in this repo is for demo purposes only, but it could be modified for functionality.

(back to top)

Related Products & Your Outfit

This is the section of site where product collections are displayed:

first: a carousel of products that are related to the current product,
second: a carousel of the user's own selected products that they add to or remove from their "Outfit" collection if they choose.

Gif of adding a product to and removing a product from the 'Your Outfit' carousel


By clicking on the Related Product of their choice, the user navigates to that product's page. This action updates all other widgets to display the data for the product selected.

Gif of changing the current product by clicking on a related product card


The action button on each Related Product's card shows a Comparing modal that displays the current product's characteristics next to those of that particular related product.

Gif of the navigation for the Related Products carousel and Comparing Modal

(back to top)

Questions & Answers

Section of store webpage for users to ask and answer questions regarding a certain product. Users will see up to 2 questions with up to 2 answers each loaded by default and depending on how many questions & answers there are.

At the top of the section there is a search bar to filter the list of questions based on user input, and the filtering of the list only takes place after at least 3 characters have been input, resetting to original list if there are less than 3 characters input.

Gif of the search in questions & answers widget


Users can also extend the questions list using the more questions button which will add 2 questions to the end of the list and disappear if there are no more questions to load. The see more answers link should extend to show all answers and change text to collapse list when fully extended, and reset back to the condensed list when collapse list is clicked. Within the list users can mark questions or answers as helpful and report them to remove unhelpful questions/answers from the list.

Gif of the list in questions & answers widget


To add a question or answer, modals will popup when the respective button/link is clicked that opens a form for user to input their question or answer. The form will validate inputs to ensure mandatory fields are filled in, emails are entered in the correct format, and not more than 5 photos are uploaded. If it passes the validation check the form inputs will be coalesced and posted to the black box and returned on any subsequent gets of the respective list.

Gif of the upload modal in questions & answers widget

(back to top)

Ratings & Reviews

This widget contains three main parts. The left-hand side shows the overall rating, as well as a breakdown of the ratings from all the reviews. Clicking on a rating allows the user to filter reviews by that star value. This section also shows the average scores for different characteristics of the item.

Gif of the reviews widget


The right-hand side shows a list of reviews that can be sorted in three different ways. Each review can be given a helpful vote or be reported. If a review has pictures, the user can click on a thumbnail to open the image in a modal.

Gif of the reviews widget


Finally, users have the ability to add new reviews to products by filling out a review form which opens in a modal. The user can give their rating, score different characteristics, add extra info and up to five images.

Gif of the new reviews form

(back to top)

Built With

  • Express
  • React
  • Node

(back to top)

Getting Started

To get a local copy of Gnicchi up and running follow these simple steps.

Prerequisites

  • node
  • npm
    npm install npm@latest -g

Installation

Requires a Hack Reactor accepted email to access the API

  1. Get a Github Personal Access Token from [https://github.com/settings/tokens][https://github.com/settings/tokens]
  2. Fork the repo
  3. Clone the repo
    git clone https://github.com/Nugget-Reactor/FEC.git
  4. Install NPM packages
    npm install
  5. Copy the exampleConfig.js and rename it config.js
  6. Enter your API key in server/Controllers/env/config.js
    'Authorization': 'INSERT GIT KEY HERE'

(back to top)

Meet the team:

🎓 All participants in this project are students in the Hack Reactor Bootcamp @ Hack Reactor

👦 Jonah Choi
      LinkedIn: @jonah-choii
      GitHub: @jonahchoi

👦 Ahmed Hanafy
      LinkedIn: @ahmed-hanafy9
      GitHub: @AhmedHanafy9

👩 Tessa Thornberry
      LinkedIn: @theresa-thornberry
      GitHub: @tessathornberry

👦 Curtis Wang
      LinkedIn: @curtis-wang
      GitHub: @cwang1014

(back to top)

About

Front End Capstone Project for Hack Reactor

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •