modern-ecommerce - GitLite

KO | EN

gitlite — search

#hacktoberfest #ai #golang #go #rust #linux #docker #nodejs #awesome #cli #vue #security #mcp #ios

modern-ecommerce

(★ 141)

Full-stack eCommerce platform built with Next.js, Nest.js, and MongoDB, featuring AI-powered product creation using Vercel AI SDK.

File Explorer

Download Latest Version (.zip)

- - .gitignore
  - .prettierignore
  - .prettierrc
  - docker-compose.yml
  - nest-cli.json
  - package.json
  - README.md
  - tsconfig.build.json
  - tsconfig.json
- - .prettierignore
  - .prettierrc
  - cookie-config.ts
  - package.json
  - tsconfig.json
- - .eslintrc.json
  - .gitignore
  - .prettierignore
  - .prettierrc
  - components.json
  - next.config.ts
  - package.json
  - postcss.config.mjs
  - README.md
  - tailwind.config.ts
  - tsconfig.json
.gitignore
LICENSE
package.json
pnpm-lock.yaml
pnpm-workspace.yaml
README.md
turbo.json

# Installation Guide

1. Get the code

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

Downloads the entire project code from GitHub to your computer.

cd modern-ecommerce

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

⚠️ This is a large repository, so this method may point to an internal sub-package rather than the actual core product. Check the full README as well.

docker compose -f apps/server/docker-compose.yml up -d --build

Runs the command against the services defined in the compose file.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

pnpm install

Downloads and installs the libraries listed in package.json.

pnpm start:server

Starts the development/run server.

pnpm start:web

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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.

![Elecshop preview image](https://raw.githubusercontent.com/NightClover-code/modern-ecommerce/main/apps/web/public/images/preview.png)

## 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

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

Go to the project directory

```bash
cd modern-ecommerce
```

Remove remote origin

```bash
git remote remove origin
```

Install dependencies (root)

```bash
pnpm install
```

Add Environment Variables - Client

<details>
  <summary>Click to expand!</summary>
  
  - `NEXT_PUBLIC_API_URL`
  - `OPENAI_API_KEY`
  - `NEXT_PUBLIC_PAYPAL_CLIENT_ID`
  - `STRIPE_SECRET_KEY`
  - `NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY`
</details>

Add Environment Variables - Server

<details>
  <summary>Click to expand!</summary>

- `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`
</details>

Start the server

```bash
pnpm start:server
```

Start the client

```bash
pnpm start:web
```

## Author
- [@achrafdev](https://achrafdev.com)

**Thanks for sharing** 🚀