This project is an e-commerce application built using React and styled with Tailwind CSS.
- Introduction
- Features
- Technologies Used
- Installation
- Usage
- Project Structure
- Contributing
- Conclusion
This project is a React-based e-commerce application that allows users to browse products, add items to their cart, and complete purchases. The app is designed with Tailwind CSS to provide a modern, responsive user interface.
- Browse and search for products
- Add items to the shopping cart
- View and update cart details
- Proceed to checkout and complete purchases
- Responsive design with Tailwind CSS
- Frontend: React
- Styling: Tailwind CSS
- Data Fetching: Axios
- API: OpenWeatherMap API (or any other weather API)
Follow these steps to set up the project locally.
- Node.js and npm installed on your machine
- Git installed on your machine
-
Clone the repository
git clone https://github.com/malthaf9/e-store cd e-store
-
Install dependencies
npm install
-
Start the development server
npm start
The application will open in your default browser at
http://localhost:3000
.
-
Browse Products
- Navigate through the product listings to find items you’re interested in.
-
Add to Cart
- Click on the "Add to Cart" button for products you want to purchase.
-
View Cart
- Access the shopping cart to review and update items.
-
Checkout
- Proceed to checkout and complete your purchase.
Here's an overview of the project structure:
e-store/ ├── public/ │ ├── favicon.ico │ ├── index.html │ ├── logo192.png │ ├── logo512.png │ ├── manifest.json │ └── robots.txt ├── src/ │ ├── components/ │ │ ├── Body.js │ │ ├── Card.js │ │ ├── Cart.js │ │ ├── Category.js │ │ ├── CategoryData.js │ │ ├── Header.js │ │ ├── MainContainer.js │ │ ├── OrderConfirmationModal.js │ │ ├── Shimmer.js │ │ └── WatchPage.js │ ├── hooks/ │ │ ├── useCard.js │ │ └── useCategory.js │ ├── utils/ │ │ ├── appStore.js │ │ ├── cardSlice.js │ │ └── constants.js │ ├── App.css │ ├── App.js │ ├── App.test.js │ ├── index.css │ ├── index.js │ ├── logo.svg │ ├── reportWebVitals.js │ └── setupTests.js ├── .gitignore ├── README.md ├── package-lock.json ├── package.json └── tailwind.config.js
Contributions are welcome! If you'd like to contribute to this project, please follow these steps:
-
Fork the repository
- Navigate to the repository you want to contribute to.
- Click the "Fork" button in the top right corner of the repository page. This will create a copy of the repository in your GitHub account.
-
Clone your forked repository
git clone https://github.com/malthaf9/e-store cd e-store
-
Create a new branch
- It is important to create a new branch for your changes to keep your
main
branch clean and to make it easier to manage multiple pull requests.
git checkout -b feature-name
- It is important to create a new branch for your changes to keep your
-
Make your changes
- Make the necessary changes in your local repository.
-
Commit your changes
- Commit your changes with a descriptive commit message.
git commit -m "Add some feature"
-
Push your changes to your forked repository
- Push your changes to the branch you created on your forked repository.
git push origin feature-name
-
Create a Pull Request
- Navigate to the original repository on GitHub.
- Click on the "Pull requests" tab.
- Click the "New pull request" button.
- Select the branch you created in your forked repository and compare it with the original repository's
main
branch. - Add a title and description to your pull request explaining what changes you have made.
- Click the "Create pull request" button.
- This project showcases how to use React and Tailwind CSS to create a dynamic, responsive weather application. Contributions are welcome to improve and expand the project. Thank you for your interest and happy coding!