Skip to content

AalaaGhanam/react-store

Repository files navigation

React Store

Welcome to the React Store project written in Typescript using ReactJS framework.

App Structure and features

Overview This is a React application built using Ant Design for UI components. It interacts with the Fake Store API (https://fakestoreapi.com/docs) to provide a seamless shopping experience.
Below are the detailed features and structure of the app:

Features

  1. Product Listing and Pagination:
  • Fetches data from the Fake Store API and displays products in a grid layout.
  • Implements client-side pagination for easier navigation through the product catalog.
  1. Product Cards:
  • Each product is displayed as a card, showing essential information such as name, price, and a thumbnail image.
  • Includes a "View" button to navigate to detailed product information.
  1. Product Details:
  • Clicking "View" on a product redirects the user to a dedicated details page (http://localhost:3000/products/:id).
  • The details page includes a description, price, category, rating, and an option to add the product to the cart.
  1. Add to Cart:
  • Users can add products to their cart from the product details page.
  • Cart data is stored in localStorage, ensuring persistence across sessions.
  1. Cart Overview:
  • Provides a summary of items added to the cart, including the total number of items and their combined price.
  • Users can view the cart and remove individual items.
  1. CFuture Enhancements:
  • User Registration: Allow users to register and create accounts.
  • Checkout Logic: Users can proceed to make orders after registration, completing the shopping experience.

Installation

Before starting development, create a feature branch from the develop branch following this pattern feature/{feature-name}/{description-of-change} .e.g. feature/card/product Clone the repository and install project dependencies by running the below commands.

  • Clone repository
git clone https://github.com/AalaaGhanam/react-store
  • Install node dependencies
npm i
  • Run Service
npm run start
  • Run Throw Docker
# Run
docker-compose up --build

# Stop
docker-compose down

The React application will be accessible at http://localhost:3000/, and the output will be the produucts list screen.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published