README.md

🛋️ Modern Furniture E-Commerce App

Welcome to the Modern Furniture E-Commerce App! This project is a complete e-commerce application for modern furniture. It features a React frontend, Java Spring Boot backend, and a MySQL database.

App Screenshots

• 
• 
• 

📋 Table of Contents

• Features
• Technologies
• Getting Started
  • Prerequisites
  • Installation
  • Running the App
• Usage
• Contributing
• License
• Contact

✨ Features

• User Authentication: Secure user authentication with JWT.
• Product Management: CRUD operations for products.
• Shopping Cart: Add, update, and remove items from the cart.
• Order Management: Place and view orders.
• Responsive Design: Fully responsive design for all devices.
• Search & Filter: Powerful search and filter options for products.

🛠 Technologies

• Frontend: React, Redux, Material-UI
• Backend: Spring Boot, Spring Security, JWT
• Database: MySQL
• Other Tools: Maven, Docker

🚀 Getting Started

Prerequisites

Make sure you have the following installed:

• Node.js (v14 or later)
• Java JDK (v11 or later)
• Maven
• MySQL
• Docker (optional, for running MySQL database)

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/modern-furniture-ecommerce.git
   cd modern-furniture-ecommerce

2. Backend Setup:

   cd ecommerce-backend
   mvn clean install

3. Frontend Setup:

   cd ecommerce-frontend
   npm install

Running the App

1. Database Setup:

   • Using Docker:

     docker run --name mysql-db -e MYSQL_ROOT_PASSWORD=root -e MYSQL_DATABASE=furniture -p 3306:3306 -d mysql:latest

   • Manually: Create a MySQL database named furniture.

2. Backend:

   cd ecommerce-backend
   mvn spring-boot:run

3. Frontend:

   cd ecommerce-frontend
   npm start

   The frontend should now be running at http://localhost:3000 and the backend at http://localhost:8080.

📖 Usage

1. Register or Login to access the app.
2. Browse the Modern Furniture collection.
3. Use the search bar or filters to find specific items.
4. Add desired items to the Cart.
5. Proceed to Checkout and place your order.
6. View your Order History and manage your account settings.

🤝 Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a new branch (git checkout -b feature/your-feature-name).
3. Commit your changes (git commit -m 'Add some feature').
4. Push to the branch (git push origin feature/your-feature-name).
5. Open a Pull Request.

Please make sure your code follows the project's coding standards and includes appropriate tests.

📜 License

This project is licensed under the MIT License. See the LICENSE file for more details.

📧 Contact

For any inquiries, please contact:

• Name: Aiman Kayad
• Email: [email protected]
• LinkedIn: Your LinkedIn

---

Thank you for checking out the Modern Furniture E-Commerce App! Happy coding! 🛋️✨