Update README.md

Author: N3m0o

README.md

@@ -1,4 +1,61 @@
-# Base layout template with Gulp, SCSS and Stylelint
-1. Create a repo using this template
-1. Replace `<your_account>` and `<repo_name>` with your Github username and the new repo name
-    - [DEMO LINK](https://<your_account>.github.io/<repo_name>/)
+# Bookstore Frontend (Uken)
+
+A responsive frontend application for an online bookstore.  
+It provides a clean UI for browsing books, navigating categories, and exploring the store’s content.  
+The project is built with React, React Router, React Swiper and deployed via GitHub Pages.
+
+---
+
+## 🚀 Live Preview
+
+🔗 **Live Demo:**  
+https://n3m0o.github.io/bookstore-frontend-uken/
+
+---
+
+## 🎨 Design Reference  
+https://www.figma.com/design/dCKPemNHoiKCX8U4IDH4bh/Book-store-Original?node-id=0-1&p=f&t=KkksRV8rNc7uMomf-0
+---
+
+## 🛠 Technologies Used
+
+- **React**
+- **React Router**
+- **React Swiper**
+- **TypeScript**
+- **CSS / SCSS**
+- **Vite**
+- **GitHub Pages**
+- **Fetch API**
+- **React Context / custom hooks**
+
+---
+
+## ✨ Features
+
+- Browse books and categories  
+- Clean and modern UI  
+- Client-side routing  
+- Responsive design  
+- Swiper-based carousels  
+- Fast GitHub Pages deployment  
+- Ready structure for connecting to an API backend  
+
+---
+
+## 📦 Getting Started
+
+Follow these steps to run the project locally.
+
+### 1. Clone the repository:
+
+```bash
+git clone https://github.com/your-username/bookstore-frontend-uken.git
+cd bookstore-frontend-uken
+```
+---
+Install dependencies:
+- npm install
+Start the project:
+- npm start
+---