Sneakers E-commerce Website

Welcome to the Sneakers E-commerce Website! This is an online platform where users can browse and purchase sneakers. The website is built using React, Vite, Tailwind CSS, and React Router DOM for a fast and seamless shopping experience.

Table of Contents

• Description
• Built With
• Getting Started
• Installation
• Usage
• Screenshots
• Contributing
• License

Description

The Sneakers E-commerce Website allows users to:

• Browse a wide range of sneakers.
• Add products to their cart.
• View product details, images, and prices.
• Proceed to checkout and complete their purchases.

This platform aims to provide a smooth and modern shopping experience with a clean and responsive design.

Built With

This project is built with the following technologies:

• React - A JavaScript library for building user interfaces
• Vite - A fast and optimized build tool for modern web projects
• Tailwind CSS - A utility-first CSS framework for rapid UI development
• React Router DOM - A library for routing in React applications

Getting Started

To get a local copy up and running, follow these simple steps:

1. Clone the repository:

   git clone https://github.com/SalahEddineMj/sneakers-e-commerce.git
   

2. Navigate into the project directory:

   cd sneakers-e-commerce
   

3. Build and run the project using Docker:

   • Ensure you have Docker installed. You can download it from here.
   • Run the following commands to build and start the project in a container:

     docker build -t sneakers-e-commerce .
     docker run -p 80:80 sneakers-e-commerce
     

   • This will build the app and run it on port 80.

Installation

Option 1: Install Locally

1. Install dependencies:

   npm install
   

2. Run the development server:

   npm run dev
   

3. Open your browser and go to http://localhost:5173 to view the app.

Option 2: Use Docker (recommended)

1. Build and run the project using the following commands:

   docker build -t sneakers-e-commerce .
   docker run -p 80:80 sneakers-e-commerce
   

   • This will start the app in a Docker container, serving it on port 80.

Usage

This project features a fully functional sneakers e-commerce website. You can:

• Browse sneakers and filter by category.
• View details of each sneaker, including images, price, and description.
• Add sneakers to your shopping cart.
• Proceed to checkout to finalize your order.

Screenshots

Contributing

We welcome contributions to improve the project. Please follow these steps to contribute:

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

License

This project is licensed under the MIT License - see the LICENSE file for details.

(back to top)