diff --git a/README.md b/README.md
new file mode 100644
index 0000000..38cbfb4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,42 @@
+# Poketo-Inspired eCommerce Site
+
+An eCommerce platform inspired by the design and functionality of [Poketo](https://www.poketo.com/). This project is built using HTML, CSS, and JavaScript as well as local storage, with a focus on user experience and seamless interaction.
+
+## Features
+
+- **User Authentication**: Allows users to register, login, and logout.
+- **Product Listings**: Display products with images, prices, and ratings.
+- **Product Detail Page**: Detailed view of individual products with available colors and sizes.
+- **Shopping Cart**: Add, remove, and update products in the cart.
+- **Responsive Design**: Mobile-friendly layout and navigation.
+
+## Usage
+
+### Homepage
+
+- Browse products from various categories.
+- Click on a product to view its details.
+
+### Product Page
+
+- View detailed information about the product.
+- Select color and size (if applicable).
+- Add the product to the cart.
+
+### Shopping Cart
+
+- View all added items.
+- Update quantities or remove items.
+- Proceed to checkout.
+
+### User Authentication
+
+- Register a new account.
+- Login with existing credentials.
+- Logout when done.
+
+
+## Acknowledgements
+
+- Inspired by the design and functionality of [Poketo](https://www.poketo.com/).
+- Built with HTML, CSS, and JavaScript.