An open API service indexing awesome lists of open source software.

https://github.com/jawed86/quickcart-ecommerce

A modern React-based e-commerce web app with cart, search, filters, discounts & responsive UI.
https://github.com/jawed86/quickcart-ecommerce

bootstrap ecommerce-website material-ui reactjs responsive-ui shopping-cart vite

Last synced: about 2 months ago
JSON representation

A modern React-based e-commerce web app with cart, search, filters, discounts & responsive UI.

Awesome Lists containing this project

README

          

# QuickCart โ€“ Modern E-Commerce Web App ๐Ÿ›’

[Live Demo ๐Ÿš€](https://quickcart-ecommerce-one.vercel.app/)

QuickCart is a responsive and dynamic e-commerce website built using **React**, **Vite**, **Material-UI**, and **Bootstrap 5**. It features real-world functionality such as product search, filtering, detailed views, cart management, and user feedback โ€” designed to demonstrate real-world frontend development skills, making it a strong addition to any portfolio or production-ready store.

---

## ๐Ÿ”ฅ Features

* ๐Ÿ๏ธ Product browsing with category, brand, and rating filters
* ๐Ÿง  Intelligent recommendations and similar items
* ๐Ÿ” Search bar with keyword-based filtering
* ๐Ÿ›’ Shopping cart with quantity control
* ๐Ÿ’ธ Discount calculation and pricing breakdown
* ๐Ÿ“œ Responsive design for desktop & mobile
* ๐Ÿ”” Snackbar alerts on cart updates
* ๐Ÿ“ข Rotating ad banners for promotions
* โšก Page scroll resets on route change
* ๐Ÿงฉ Cart data persists on page refresh using localStorage
---

## ๐Ÿ› ๏ธ Tech Stack

* **Frontend:** React, Vite
* **Styling:** Material-UI, Bootstrap 5, Custom CSS
* **State Management:** React Context API
* **Routing:** React Router v7+
* **Notifications:** Notistack
* **Deployment:** Vercel

---

## ๐Ÿš€ Getting Started

Clone the repo and install dependencies:

```bash
git clone https://github.com/YOUR_USERNAME/quickcart.git
cd quickcart
npm install
npm run dev
```

To build and preview production locally:

```bash
npm run build
npm run preview
```

---

## ๐Ÿ“€ Folder Structure

```
quickcart/
โ”œโ”€โ”€ public/
โ”‚ โ””โ”€โ”€ screenshots/ # UI screenshots for documentation
โ”‚
โ”œโ”€โ”€ src/
โ”‚ โ”œโ”€โ”€ appRoutes/ # Centralized routing definitions
โ”‚ โ”œโ”€โ”€ components/ # Reusable UI components (advertisement Banner, Footer, etc.)
โ”‚ โ”œโ”€โ”€ context/ # Context API for state management
โ”‚ โ”œโ”€โ”€ others/ # SnackBar, EmptyCart, etc.
โ”‚ โ”œโ”€โ”€ pages/ # Page-level components (Home, Cart, Navbar, DetailPage, etc.)
โ”‚ โ”œโ”€โ”€ utils/ # Utility functions (localStorage helpers, Data.js etc.)
โ”‚ โ”œโ”€โ”€ App.jsx # Root component
โ”‚ โ”œโ”€โ”€ main.jsx # Entry point
โ”‚ โ””โ”€โ”€ index.css # Global styles
โ”‚
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ package-lock.json
โ”œโ”€โ”€ vite.config.js
โ”œโ”€โ”€ eslint.config.js
โ””โ”€โ”€ README.md
```

---

## ๐Ÿ“ธ Screenshots

### ๐Ÿ  Homepage
![Homepage](public/screenshots/home.png)

### ๐Ÿ” Search Page
![Search Page](public/screenshots/Search%20Page.png)

### ๐Ÿงพ Cart Page
![Cart Page](public/screenshots/Cart%20page.png)

### ๐Ÿงฉ Detail Page
![Detail Page](public/screenshots/Detail%20Page.png)

### ๐Ÿ“Œ Navbar
![Navbar 1](public/screenshots/navbar1.png)
![Navbar 2](public/screenshots/navbar2.png)

### ๐Ÿ”„ Related Items
![Related Item](public/screenshots/Related%20Item.png)

---

## ๐Ÿค Acknowledgements

This project was built as part of my portfolio to demonstrate proficiency in React-based frontend development, UI/UX, and responsive e-commerce interfaces.

---

## ๐Ÿ”— License

This project is open-source and available under the [MIT License](LICENSE).