🚀 CodeClusters

yourShop is a full-stack web application built with Node.js, MongoDB, and React.js, featuring:

• A user-facing frontend
• A backend API server
• An admin dashboard for internal management

🌐 Live Website

📚 Explore Project Resources: Wiki and Github Project

Check out our Wiki for docs, and manage the project on Github.

🚀Project Status and Quality Metrics

🤝Team Information: codeclusters

Name	Role	GitHub Username
Tutul Kumar Biswas	Team Leader	nottutul
Md Mahamudul Hassan Barshan	Member	mhbarshan
Md. Sajidur Rahman Labib	Member	labib1910024
Hasibul Hasan	Mentor	Siam456

📄Project Description

developed with the MERN stack (MongoDB, Express.js, React, Node.js). Designed to deliver a seamless and engaging shopping experience, the platform comes packed with powerful features such as:

🔐 User Authentication & Management

🛍️ Dynamic Product Listings

🛒 Interactive Shopping Cart

💳 Secure Payment Integration

🛠️ Admin Dashboard for Product Management

With MongoDB as our database, we ensure scalable, flexible, and high-performance data handling—perfect for modern e-commerce needs..

📁 Project Structure Overview

codeclusters/
├── admin/      # Admin dashboard (React.js)
├── backend/    # API server (Node.js)
├── frontend/   # User-facing app (React.js)

---

🛠️ Installation & Setup

📦 Prerequisites

Make sure you have:

• Node.js (v18 or higher)
• npm (or pnpm)
• Git

---

1. Clone the Repository

git clone https://github.com/Learnathon-By-Geeky-Solutions/codeclusters.git
cd codeclusters

2. Install Dependencies

Backend

cd backend
npm install

Frontend

cd ../frontend
npm install

Admin Panel

cd ../admin
npm install

---

▶️ Running the Project

1. Start Backend

cd backend
npm run dev

2. Start Frontend

Open a new terminal window/tab:

cd frontend
npm run dev

3. Start Admin Panel

Open another terminal:

cd admin
npm run dev

By default:

• Frontend runs on http://localhost:5173
• Admin Panel runs on http://localhost:5174 (or another port if specified)
• Backend runs on http://localhost:5000

---

⚙️ Environment Variables

Check for .env.example in each of the three folders (backend, frontend, admin). Copy and rename to .env, then configure as needed:

cp .env.example .env

Make sure all required environment variables (like database URIs, API endpoints, secrets) are set properly.

---

✅ Done!

Now your development environment should be up and running for:

• 📱 Frontend (user-facing)
• 🛠️ Backend (API and logic)
• 👩‍💼 Admin (dashboard/control panel)

---

📄 Additional Resources

• Project Repository
• Issues & Discussions

📬 Questions?

Feel free to open an issue if you run into problems or have suggestions.

📄 License

MIT License © CodeClusters