A modern, full-stack E-Commerce platform built with Next.js 15 and Node.js/Express. This project features a polished user interface, a dedicated seller portal, and a comprehensive admin dashboard.
- Advanced Search & Filtering: Find products instantly with full-text search and multi-faceted filters (category, price, rating).
- Secure Authentication: JWT-based login, registration, and password reset.
- Cart & Checkout: Persistent shopping cart with a smooth, secure checkout process.
- Order Tracking: Real-time status updates on orders (Processing, Shipped, Delivered).
- User Dashboard: Manage profile, view order history, and save items to Wishlist.
- Reviews: Rate and review purchased products.
- Inventory Management: Add, edit, and delete products with ease.
- Sales Analytics: Visual charts to track revenue and order trends.
- Order Management: View and process customer orders specific to your products.
- User & Seller Oversight: Manage all user accounts and monitor seller activities.
- Content Management: Update homepage banners, sponsored listings, and contact inquiries.
- Marketing Tools: Create and manage discount coupons/vouchers.
- Email Campaigns: Send system-wide announcements via Nodemailer.
- Media Library: Manage all uploaded images through Cloudinary integration.
| Module | Key Capabilities |
|---|---|
| Authentication | Secure JWT-based login, Registration, Password Reset, Role-based Access Control (RBAC) |
| Catalog | Categories, Advanced Search, Sorting, Filtering, Product Reviews, Sponsored Listings |
| Checkout | Persistent Cart, Order Summary, Shipping Address Management, Payment Integration |
| Communication | Automated Email Notifications, Contact Form Management, Admin Announcement Emails |
| Media | High-performance image hosting with Cloudinary, Admin Media Library |
| Analytics | Dashboard Charts, Sales Reports, Traffic Monitoring |
- Frontend: Next.js 15, TypeScript, TailwindCSS, Redux Toolkit.
- Backend: Node.js, Express, MongoDB.
- Services: Cloudinary (Image Hosting), Nodemailer (Emails).
git clone https://github.com/VortexDevX/E-Commerce.git
cd E-CommerceNavigate to the backend directory and install dependencies:
cd backend
npm installCreate a .env file in the backend directory with the following variables:
PORT=8080
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secure_random_string
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secretStart the backend server:
npm run dev
# Server will start on http://localhost:8080Open a new terminal, navigate to the frontend directory and install dependencies:
cd ../frontend
npm installCreate a .env.local file in the frontend directory:
NEXT_PUBLIC_API_URL=http://localhost:8080/apiStart the frontend development server:
npm run dev
# App will run on http://localhost:3000For a deep dive into the project structure, API endpoints, and architectural decisions, please refer to the Technical Documentation.
Contributions are welcome! Please follow these steps:
- Fork the project.
- Create your feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'Add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
Distributed under the ISC License.