🛒 Full-Stack E-Commerce Platform (Amazon-Style)

A modern, scalable full-stack e-commerce application built with Next.js, NestJS, Prisma, and PostgreSQL (Neon). This project replicates core Amazon-like features including authentication, product management, shopping cart, and an admin dashboard.

---

🚀 Tech Stack

Frontend

• Next.js (App Router)
• Tailwind CSS
• ShadCN UI
• React Hooks & Context API
• Clerk/Auth (or custom auth)

Backend

• NestJS (Modular Architecture)
• Prisma ORM
• PostgreSQL (Neon)
• JWT Authentication
• REST API

---

📦 Features

🔐 Authentication

• User Signup / Login
• Secure JWT-based authentication
• Protected routes

🛍️ E-Commerce Core

• Product listing
• Product details page
• Category filtering
• Search functionality
• Add to cart
• Checkout flow (basic)

🧑‍💼 Admin Dashboard

• Create / update / delete products
• Manage users
• View orders
• Analytics-ready structure

🛒 Cart System

• Persistent cart
• Quantity management
• Price calculation

---

🧱 Project Structure (Monorepo)

root/
│
├── frontend/        # Next.js app
├── backend/         # NestJS API
├── prisma/          # Prisma schema & migrations
└── README.md

---

⚙️ Setup Instructions

1. Clone the Repository

git clone https://github.com/YOUR_USERNAME/YOUR_REPO.git
cd YOUR_REPO

2. Install Dependencies

# frontend
cd frontend
npm install

# backend
cd ../backend
npm install

---

3. Environment Variables

Create .env files in both frontend and backend.

Backend .env

DATABASE_URL=your_neon_postgres_connection
JWT_SECRET=your_secret_key
PORT=5000

Frontend .env

NEXT_PUBLIC_API_URL=http://localhost:5000

---

4. Prisma Setup

cd backend
npx prisma generate
npx prisma migrate dev

---

5. Run the Project

# backend
cd backend
npm run start:dev

# frontend
cd frontend
npm run dev

---

🌐 Screenshots

Add screenshots inside:

/public/screenshots/

Then reference them like:

![Homepage](public/screenshots/home.png)
![Dashboard](public/screenshots/admin.png)

---

🔗 Live Demo

• Frontend: https://your-frontend-url.com
• Backend API: https://your-api-url.com

---

🧠 Key Concepts Used

• Full-stack architecture separation
• REST API design
• Authentication & authorization
• Database modeling with Prisma
• Component-driven UI

---

📈 Future Improvements

• Payment integration (Stripe)
• Order tracking system
• Reviews & ratings
• Advanced analytics dashboard
• Microservices scaling

---

🤝 Contributing

Pull requests are welcome. For major changes, open an issue first.

---

📄 License

MIT License

---

💡 Author

Built by a full-stack developer focused on scalable systems, performance, and clean architecture.