Skip to content

NestMart Shop is a modern and responsive frontend application built to manage products, customers, and sales for a local retail store. Designed to work seamlessly with the NestJS backend, it supports features like role-based dashboards, product listings, sales management, and customer tracking.

BottomsNode/Nest-Mart-Shop-Frontend-React

Repository files navigation

🛒 Nest Mart Shop

Nest Mart Shop is a modern e-commerce platform built with React (frontend) and NestJS (backend). It supports essential online shopping features including product management, cart handling, customer authentication, and order processing — all designed with scalability and performance in mind.


🚀 Tech Stack

🧠 Backend – NestJS

  • RESTful APIs with NestJS
  • PostgreSQL with TypeORM
  • Authentication (JWT-based)
  • Role & Permission system
  • Global middleware, interceptors & guards
  • Swagger API documentation

🎨 Frontend – React

  • Modern UI with React + Tailwind CSS
  • Redux Toolkit for state management
  • Dynamic product listing and detail views
  • Cart, Checkout, and Order Summary
  • Form validation & responsive layout

📦 Features

  • 👤 User Signup/Login (JWT)
  • 🛍️ Product Listing & Filters
  • 🛒 Add to Cart & Quantity Management
  • 💳 Order Placement & Summary
  • 🧾 PDF Invoice Generation (jsPDF)
  • 📈 Admin Dashboard (coming soon)
  • 📷 Product Image Upload (via Cloudinary)

🧪 Live Demo (Backend Swagger)

🔗 NestJS Swagger API Docs
(Link shared for testing purposes if same backend is used)


🛠️ Setup Instructions

1. Clone the Repository

git clone https://github.com/your-username/nest-mart-shop.git
cd nest-mart-shop

2. Set up Backend

cd backend
cp .env.example .env
yarn install
yarn start:dev

3. Set up Frontend

cd frontend
cp .env.example .env
yarn install
yarn dev

🧾 Folder Structure

nest-mart-shop/
├── backend/            # NestJS API
├── frontend/           # React client
├── docs/               # API specs, diagrams
└── README.md

📌 To-Do / Roadmap

 Admin Dashboard UI (Product / Order management)
 Payment Gateway Integration
 Product Reviews & Ratings
 Multi-language support
 Responsive email templates

✨ Contributing

Pull requests are welcome! If you find bugs or have ideas, feel free to fork and improve the project.

🧑‍💻 Author

Made with ❤️ by Nishit Shivdasani 🔗 GitHub

📃 License

This project is open-source under the MIT License.

About

NestMart Shop is a modern and responsive frontend application built to manage products, customers, and sales for a local retail store. Designed to work seamlessly with the NestJS backend, it supports features like role-based dashboards, product listings, sales management, and customer tracking.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages