🛍️ Fullstack E-Commerce Website (Django + React)

A complete fullstack e-commerce platform built with Django (backend) and React (frontend).
This project delivers a functional online shopping experience with authentication, product management, and payment integration.

---

👨‍💻 Team Members

Name	Role	Links
Yared Gezahegn	Frontend Developer (React, Bootstrap, UX/UI)	GitHub · LinkedIn
Yosef Abire	Backend Developer (Django, REST API, DB Design)	GitHub · LinkedIn

---

🚀 Project Overview

A production-ready full e-commerce platform built using:

• Django for backend API
• React for frontend UI
• Flutterwave & PayPal for payments
• PostgreSQL or MySQL for database
• Fully responsive design

This project is perfect for learning fullstack architecture, API design, and modern frontend development.

---

🧩 Features

• 🛒 Product Listing, Search & Filtering
• 👤 JWT-Based Authentication
• 🛍️ Cart & Checkout Flow
• 💳 Flutterwave + PayPal Payment Integration
• 📦 Admin Dashboard
• 📱 Fully Responsive UI
• 🚀 REST API with Django
• 🐳 Optional Docker Support

---

🛠️ Tech Stack

Frontend

• React
• Bootstrap
• Axios
• React Router DOM

Backend

• Django
• Django REST Framework
• PostgreSQL / MySQL
• ElasticSearch (for optimized search)

Payments

• Flutterwave
• PayPal

DevOps / Tools

• GitHub
• VS Code
• Docker (optional)

---

⚙️ Installation & Setup

1️⃣ Clone the Repository

git clone https://github.com/JaredGezahegn/Ecomerce-App.git

---

▶️ Backend Setup (Django)

Navigate to the backend folder:

cd backend

Create and activate a virtual environment:

python -m venv venv
venv\Scripts\activate  # Windows

Install dependencies:

pip install -r requirements.txt

Run migrations:

python manage.py migrate

Start the server:

python manage.py runserver

The backend runs at:

http://127.0.0.1:8000/

---

💻 Frontend Setup (React)

Navigate to the frontend folder:

cd frontend

Install dependencies:

npm install

Start the development server:

npm run dev

Frontend runs at:

http://localhost:5173/

---

📁 Folder Structure

Ecommerce-App/
│
├── backend/
│   ├── ecommerce/         # Django project
│   ├── products/          # Products app
│   ├── orders/            # Orders app
│   ├── users/             # Auth system
│   └── ...
│
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── api/
│   │   └── ...
│   └── public/
│
└── README.md

---

📦 Running the App Together

1. Start Django backend
2. Start React frontend
3. Ensure CORS and .env values match
4. Open the browser and test features

---

🙌 Contributing

Pull requests are welcome!

---

🌟 Show Support

Leave a ⭐ on the repo if you found it helpful!