Skip to content

SolBingers/nice_store

Repository files navigation

Nice Store Full-stack Project

Welcome to the Nice Store Full-stack Project! This README file will provide you with an overview of our project, its features, and instructions on how to set it up and get started.

Project Description

Nice Store is platform that offers a wide range of gadgets for tech enthusiasts. Our goal is to provide an enjoyable shopping experience where users can explore and purchase their favorite gadgets with ease. This project focuses on both the frontend and backend aspects, creating a full-stack application that covers all necessary functionalities. Here you can see the Front-end side.

Back-end - HERE

Preview

You can see the demo HERE

Features

The Nice Store Project includes the following key features:

  • Product Catalog: Users can browse through a vast selection of gadgets, with detailed information and images for each product.
  • Search and Filtering: Customers can search for specific gadgets using keywords and apply filters to refine their search results.
  • Shopping Cart: Users can add items to their shopping cart, review the contents, and proceed to checkout for secure payments.
  • Favourites: Users can add item to the favourites and explore them on the favourites page

Technologies Used

The Nice Store utilizes the following technologies:

  • Frontend: HTML, SCSS, TypeScript, React.js, ReactQuery, Swiper.js, Clerk, React-Hook-Form for building the user interface and managing state.
  • Backend: Node.js, Express.js, and Sequelize.js for creating a RESTful API and managing data storage.
  • Database: Postgress for storing product information, user data, and order details.

Installation

To install and set up the Nice Store on your local machine, follow these steps:

  1. Clone the project repository from GitHub:

    git clone https://github.com/nicestore/nice-store.git
  2. Navigate to the project directory:

    cd nice-store
  3. Install the dependencies for the frontend and backend. Run the following command::

    npm install
  4. Start the development server. Run the following command:

    npm start

    The server will be accessible at http://localhost:3000.

Usage

Once the project is up and running, you can access the Nice Store application in your web browser. Here are a few instructions on how to use the application:

  • Upon accessing the Nice Store application in your web browser, you will be presented with the homepage showcasing featured gadgets and product categories.

  • You can browse through the different categories and use the search functionality to find specific gadgets. Clicking on a product will take you to the detailed product page, where you can view additional information and images.

  • You can add items to your shopping cart by selecting the desired quantity and clicking the "Add to Cart" button. And also you can add some item to your favourites by clicking on heart buttons.

Contributing

We welcome contributions to the Nice Store Project! If you would like to contribute, please follow these steps:

  1. Fork the project repository on GitHub.
  2. Create a new branch for your feature or bug fix.
  3. Implement your changes and ensure that the code adheres to the project's coding style and guidelines.
  4. Commit and push your changes to your forked repository.
  5. Submit a pull request with a detailed description of your changes and the problem it solves.
  6. Your pull request will be reviewed by the project maintainers, and any necessary feedback or adjustments will be provided.
  7. Once your changes have been approved, they will be merged into the main repository.