diff --git a/README.md b/README.md
index 58f747fab..26215cac6 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,28 @@
-# ECShopX_mobile
-ECShopX移动端，Taro3.0框架，包含微信小程序、H5、APP
+<p align="center"><img width="300" height="auto" alt="ECShopX" src="https://github.com/user-attachments/assets/64db28c5-ce48-43aa-887f-1c926498f55b" /></p>
+
+### <p align="center">Mobile Frontend</p>
+
+# Getting started
+Node.js (current LTS) and npm are required to run the project. To be sure about the version compatibility you can enable Node's corepack.
+
+### Installation
+```
+cd ecshopx-vshop
+npm i
+```
+
+### Run project 
+```
+npm run dev:h5
+```
+```
+npm run dev:weapp
+```
+
+### Build packages 
+```
+npm run build:weapp
+```
+```
+npm run build:weapp
+```