Skip to content

AimanK/ecommerce

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

26 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛋️ 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

  • Screenshot 2024-06-25 at 11 34 50 PM
  • Screenshot 2024-06-25 at 11 35 10 PM
  • Screenshot 2024-06-25 at 11 34 34 PM

📋 Table of Contents

✨ 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:

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:


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