Advanced E-Commerce Platform

Production-oriented full-stack e-commerce starter with:

• frontend: Next.js 14+ App Router, Tailwind, Framer Motion, next-themes, reusable UI primitives
• backend: Express, MongoDB/Mongoose, JWT auth, RBAC, Stripe/PayPal-ready services, Cloudinary-ready image pipeline

Quick Start

1. Install dependencies:

npm run install:all

2. Configure env files:

• Copy frontend/.env.example to frontend/.env.local
• Copy backend/.env.example to backend/.env

3. Run both servers in two terminals:

npm run dev:backend
npm run dev:frontend

Frontend: http://localhost:3000
Backend: http://localhost:5000

4. Seed initial real-world demo data:

npm run seed:admin
npm run seed:store
npm run seed:demo
# or one command:
npm run seed:all

Monorepo Structure

frontend/   # Next.js app
backend/    # Express API

Core Features Included

• JWT auth with access + refresh tokens
• Role-based authorization (admin, customer, vendor)
• Product, category, cart, order, coupon, review, wishlist APIs
• B2B RFQ flow (/api/rfqs) with buyer requests and supplier responses
• Supplier storefront APIs (/api/suppliers) and public supplier discovery
• Guest-first flow: browse/search/details/cart without login, auth required at checkout/order actions
• Admin supplier verification control (verifiedSupplier) in dashboard users management
• Security middleware: Helmet, CORS, rate limiting, sanitization, validation
• Responsive premium UI with light/dark mode, transitions, glassmorphism, skeleton loading
• Checkout flow scaffold with Stripe/PayPal service integration points
• SEO essentials: metadata, sitemap, robots, structured product data

Notes

• Redis is optional and auto-falls back if not configured.
• Stripe/PayPal/Cloudinary/Nodemailer keys are optional in development and are guarded.
• This is scaffolded to be extensible; add provider keys and business rules for production deployment.