Elecshop - Modern eCommerce Platform

A full-stack eCommerce platform built with Next.js, Nest.js, and MongoDB, featuring AI-powered product management and modern authentication.

Features 🚀

Core Features

• Full-featured shopping cart with:
  • server-side persistence for logged in users
  • local storage for guests
• Product reviews and ratings system
• Advanced product search with pagination
• User account management & order history
• Secure authentication with JWT (access & refresh tokens)
• Role-based access control (Admin/User)

AI-Powered Features

• AI Product Creator for generating product listings (Vercel AI SDK)
• Image generation for product images (using Replicate)
• Product Development Expert chat interface
• Smart product recommendations

Technical Highlights

• Modern monorepo structure with apps for web and server
• Type-safe API communication with shared types
• Real-time updates using modern state management
• Cloudinary integration for image management
• Secure payment processing with PayPal and Stripe
• Modern UI with Shadcn components and Tailwind CSS

Tech Stack 💻

Frontend

• Next.js 15 with App Router
• TypeScript
• Tailwind CSS
• Shadcn UI Components
• Framer Motion for animations
• Chat interface with Vercel AI SDK

Backend

• Nest.js with TypeScript
• MongoDB with Mongoose
• JWT Authentication
• Swagger API Documentation
• Argon2 for password hashing
• Cloudinary for media storage
• OpenAI integration
• Text Vercel AI SDK
• Replicate for image generation

DevOps & Tools

• Monorepo architecture
• pnpm for package management
• Docker support
• Railway for backend deployment
• Vercel for frontend deployment

Getting Started 🏃

Prerequisites

• Node.js (v16 or higher)
• pnpm (preferred package manager)
• MongoDB instance (Docker preferred)

Running Locally 🖥️

Clone the project

git clone https://github.com/NightClover-code/modern-ecommerce.git

Go to the project directory

cd modern-ecommerce

Remove remote origin

git remote remove origin

Install dependencies (root)

pnpm install

Add Environment Variables - Client

Click to expand!

• NEXT_PUBLIC_API_URL
• OPENAI_API_KEY
• NEXT_PUBLIC_PAYPAL_CLIENT_ID
• STRIPE_SECRET_KEY
• NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY

Add Environment Variables - Server

Click to expand!

• ALLOWED_ORIGINS
• PORT
• JWT_SECRET
• JWT_ACCESS_SECRET
• JWT_REFRESH_SECRET
• CLOUDINARY_CLOUD_NAME
• CLOUDINARY_API_KEY
• CLOUDINARY_API_SECRET
• MONGODB_URI
• MONGO_USERNAME
• MONGO_PASSWORD
• REPLICATE_API_TOKEN
• OPENAI_API_KEY

Start the server

pnpm start:server

Start the client

pnpm start:web

Author

• @achrafdev

Thanks for sharing 🚀