https://github.com/naviandrei/ecommerce-pro
Full-stack ecommerce application built with React, Django, and SQLite. Portfolio project showcasing modern web development.
https://github.com/naviandrei/ecommerce-pro
django javascript python react react-router
Last synced: 5 days ago
JSON representation
Full-stack ecommerce application built with React, Django, and SQLite. Portfolio project showcasing modern web development.
- Host: GitHub
- URL: https://github.com/naviandrei/ecommerce-pro
- Owner: NaviAndrei
- License: mit
- Created: 2025-04-01T15:32:23.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-02T17:56:39.000Z (about 1 year ago)
- Last Synced: 2025-04-28T16:56:57.040Z (about 1 year ago)
- Topics: django, javascript, python, react, react-router
- Language: JavaScript
- Homepage: https://naviandrei.github.io/ecommerce-pro/
- Size: 1.79 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# EcoShop - Full-Stack Ecommerce Project
A modern, responsive ecommerce web application built to showcase full-stack development skills.
---
## 🌟 About The Project
EcoShop is a full-stack web application designed as a portfolio piece. It simulates a real-world online store, featuring product displays, user interactions, and a clean interface. The project demonstrates proficiency in both frontend and backend development, creating a seamless user experience.
**Live Demo:** [https://naviandrei.github.io/ecommerce-pro/](https://naviandrei.github.io/ecommerce-pro/)
---
## ✨ Features
* **Product Catalog:** Browse products with images, descriptions, and prices.
* **Featured Products:** Highlights specific products on the homepage.
* **Responsive Design:** Adapts to various screen sizes (desktops, tablets, mobiles).
* **Styled Components:** Modern UI built with styled-components for maintainable CSS.
* **Homepage:** Engaging hero section, promotional banners, and featured product grid.
* **Newsletter Signup:** Functional signup form (currently mocked, adaptable for backend integration).
* **(Add more features as you implement them, e.g., Product Details Page, Cart, User Auth, Checkout)**
---
## 🛠️ Technologies Used
* **Frontend:**
* React.js
* React Router
* Styled Components
* `fetch` API (for interacting with backend)
* **Backend:**
* Python
* Django
* SQLite3 (for development)
* **Development Tools:**
* Git & GitHub
* pip (Python package installer)
---
## 🚀 Getting Started
To get a local copy up and running, follow these simple steps.
### Prerequisites
* Node.js & npm (or yarn) installed: [https://nodejs.org/](https://nodejs.org/)
* Python 3.x installed: [https://www.python.org/](https://www.python.org/)
* pip installed (usually comes with Python)
### Installation & Setup
1. **Clone the repository:**
```bash
git clone https://github.com/NaviAndrei/EcommercePro.git
cd EcommercePro
```
2. **Backend Setup:**
* Navigate to the backend directory (if separate): `cd backend` *(Adjust path if needed)*
* **(Optional but recommended) Create and activate a virtual environment:**
```bash
python -m venv venv
# On Windows
.\venv\Scripts\activate
# On macOS/Linux
# source venv/bin/activate
```
* Install Python dependencies:
```bash
pip install -r requirements.txt
```
*(Ensure you have a `requirements.txt` file in your backend directory)*
* Apply database migrations:
```bash
python manage.py migrate
```
* **(Optional) Create a superuser for the Django admin:**
```bash
python manage.py createsuperuser
```
* Start the backend server:
```bash
python manage.py runserver
```
*Make note of the port the backend runs on (default is 8000).*
3. **Frontend Setup:**
* Navigate to the frontend directory: `cd ../frontend` *(Adjust path if needed)*
* Install dependencies:
```bash
npm install
# Or using yarn
# yarn install
```
* Configure API endpoint: Ensure the frontend code (e.g., in `HomePage.jsx` or a config file) points to the correct backend server address (e.g., `http://localhost:8000/api`).
* Start the frontend development server:
```bash
npm start
# Or using yarn
# yarn start
```
4. Open your browser and navigate to `http://localhost:3000` (or the port specified by the React development server).
---
## 📜 License
Distributed under the MIT License. See `LICENSE` file for more information.
---
## 👤 Contact
Andrei Ivan
* **Website:** [https://syncwithivan.com](https://syncwithivan.com)
* **Email:** [ivan.andrei@syncwithivan.com](mailto:ivan.andrei@syncwithivan.com)
* **Project Link:** [https://github.com/NaviAndrei/EcommercePro](https://github.com/NaviAndrei/EcommercePro)
---
Thank you for checking out EcoShop!