QuickMart is a complete full-stack e-commerce platform that connects buyers and sellers through an intuitive, feature-rich online marketplace. Built with Angular 17 for dynamic frontend experiences and Spring Boot 3 for robust backend APIs, QuickMart delivers a seamless shopping experience with powerful administrative controls.
"To provide a reliable, secure, and user-friendly e-commerce solution that empowers customers to shop conveniently while giving administrators complete control over their online store."
Icon
Feature
Description
🔐
Authentication Secure JWT-based login and registration
🛍️
Product Catalog Browse with search, filters, and sorting
🔍
Product Details High-quality images and detailed info
🛒
Shopping Cart Add/remove items, update quantities
💝
Wishlist Save favorite products
💳
Multiple Payments COD, UPI, Credit/Debit cards
📦
Order Tracking Real-time tracking with timeline
⭐
Reviews & Ratings Submit feedback and rate products
👤
Profile Management Update personal information
📱
Responsive Design Works on all devices
Icon
Feature
Description
📊
Analytics Dashboard Real-time statistics and insights
➕
Product Management Complete CRUD operations
📦
Order Management Full order lifecycle management
🚚
Shipping Integration Add courier and tracking details
📢
Announcements Publish updates for customers
💬
Feedback Management View and respond to feedback
👥
User Management Manage registered users
┌─────────────────────────────────────────────────────────────────┐
│ │
│ 📝 PENDING ──→ ✅ CONFIRMED ──→ 🚚 SHIPPED ──→ 🎉 DELIVERED │
│ │ │ │
│ ↓ ↓ │
│ ❌ CANCELLED ❌ CANCELLED │
│ │
└─────────────────────────────────────────────────────────────────┘
text
💳 Payment Methods Supported
Icon
Method
Status
💰
Cash on Delivery
✅ Available
📱
UPI (Google Pay, PhonePe, Paytm, BHIM)
✅ Available
💳
Credit/Debit Card (Visa, Mastercard, RuPay)
✅ Available
🏦
Net Banking
🔜 Coming Soon
Technology
Version
Purpose
Angular
17.x
Frontend framework
TypeScript
5.x
Programming language
Angular Material
17.x
UI components
RxJS
7.x
State management
CSS3
-
Styling & animations
Technology
Version
Purpose
Spring Boot
3.2.x
REST API framework
Spring Data JPA
3.2.x
Database operations
MySQL
8.0
Relational database
Hibernate
6.x
ORM mapping
Maven
3.9+
Dependency management
Tool
Version
Purpose
Node.js
v18 or higher
Angular runtime
Angular CLI
v17
Angular CLI tool
Java JDK
17+
Spring Boot runtime
MySQL
8.0+
Database
Maven
3.9+
Build tool
📥 Step 1: Clone Repository git clone https://github.com/yourusername/quickmart.git
cd quickmart
⚙️ Step 2: Backend Setup
bash
# Navigate to backendcd backend
# Create database;
EXIT;
📝 Configure application.properties:
properties
# Server# Database# JPA# CORS# Build and run# Navigate to frontendcd ../frontend
# Install dependencies# Run application
Method
Endpoint
Description
Access
POST
/api/auth/registerUser Registration
Public
POST
/api/auth/loginUser Login
Public
GET
/api/auth/allGet All Users
Admin
DELETE
/api/auth/{id}Delete User
Admin
Method
Endpoint
Description
Access
GET
/api/user/itemsGet All Products
Public
GET
/api/user/items/{id}Get Product By ID
Public
POST
/api/admin/products/addAdd Product
Admin
PUT
/api/admin/products/{id}Update Product
Admin
DELETE
/api/admin/products/{id}Delete Product
Admin
Method
Endpoint
Description
Access
GET
/api/salesGet All Orders
Admin
GET
/api/sales/buyer/{buyer}Get User Orders
User
POST
/api/salesCreate Order
User
PATCH
/api/sales/admin/status/{id}Update Order Status
Admin
PATCH
/api/sales/admin/shipping/{id}Add Shipping Details
Admin
Method
Endpoint
Description
Access
GET
/api/announcementsGet All Announcements
Public
POST
/api/admin/announcementsCreate Announcement
Admin
DELETE
/api/admin/announcements/{id}Delete Announcement
Admin
Method
Endpoint
Description
Access
GET
/api/feedbackGet All Feedback
Admin
POST
/api/feedbackSubmit Feedback
User
DELETE
/api/admin/feedback/{id}Delete Feedback
Admin
Step
Action
1
Register / Login
2
Browse Products (Search, Filter, Sort)
3
View Product Details
4
Add to Cart
5
Add to Wishlist (Optional)
6
Proceed to Checkout
7
Enter Shipping Address
8
Select Payment Method
9
Place Order
10
Track Order Status
11
Receive Updates
12
Submit Feedback
Step
Action
1
Login with Admin Credentials
2
View Dashboard Analytics
3
Manage Products (CRUD)
4
Process Incoming Orders
5
Confirm Pending Orders
6
Add Courier & Tracking Details
7
Mark Orders as Shipped
8
Mark Orders as Delivered
9
Publish Announcements
10
Review Customer Feedback
Method
Credentials
UPI
test@okhdfcbank
Card Number
4111 1111 1111 1111
Expiry
12/25
CVV
123
quickmart/
│
├── frontend/ # Angular App
│ ├── src/app/
│ │ ├── components/ # Reusable Components
│ │ ├── models/ # Data Interfaces
│ │ ├── pages/
│ │ │ ├── admin/ # Admin Modules
│ │ │ └── user/ # User Modules
│ │ └── services/ # API Services
│ └── package.json
│
├── backend/ # Spring Boot Application
│ ├── src/main/java/
│ │ └── com/marketplace/E_commerce/
│ │ ├── controllers/ # REST Controllers
│ │ ├── models/ # Entity Classes
│ │ ├── repositories/ # Database Operations
│ │ └── services/ # Business Logic
│ └── pom.xml
│
└── database/
└── schema.sql
Problem
Solution
🌐 CORS Error
Add @CrossOrigin(origins = "http://localhost:4200")
🔌 Database Connection Failed
Verify MySQL Service Is Running
🖼️ Images Not Loading
Check uploads/ Directory
🔐 Login Failed
Clear Browser Local Storage
🔌 Port Already In Use
Change server.port
📦 npm Installation Errors
Delete node_modules and Reinstall
# Check Backend Health# Check Database" SELECT 1" # Check Port (Windows)| findstr :8080
# Check Port (Linux/Mac)# Clear Angular Cache
Feature
Status
📧 Email Notifications
🔜 Planned
📱 SMS Alerts
🔜 Planned
🌐 Multi-language Support
🔜 Planned
📸 Review Images
🔜 Planned
🏷️ Discount Coupons
🔜 Planned
📄 PDF Invoices
🔜 Planned
🔗 Social Login
🔜 Planned
🤖 AI Recommendations
🔜 Planned
💬 Live Chat Support
🔜 Planned
🤝 Contributing Guidelines
Step
Action
1
Fork the Repository
2
Create a Feature Branch
3
Commit Your Changes
4
Push Changes to GitHub
5
Open a Pull Request
✅ Follow Angular Style Guide
✅ Write Meaningful Commit Messages
✅ Add Comments for Complex Logic
✅ Test Before Submitting
✅ Update Documentation
MIT License
Copyright (c) 2026 QuickMart
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files...
Contributor
🅰️ Angular Team
☕ Spring Boot Team
🐬 MySQL Team
🎨 Angular Material
👥 Open Source Contributors
Action
Icon
Star This Repository
⭐
Fork This Repository
🍴
Share With Others
📢
Report Issues
🐛
Suggest Features
💡
"QuickMart – Making Online Shopping Quick & Easy" Built with ❤️ by Pranav Sali
© 2026 QuickMart. All Rights Reserved.
⭐ Star this repository if you like this project! ⭐
