diff --git a/frontend-h5/README.md b/frontend-h5/README.md
new file mode 100644
index 0000000..f5d63e8
--- /dev/null
+++ b/frontend-h5/README.md
@@ -0,0 +1,27 @@
+# frontend-h5
+
+H5 材料浏览端。
+
+## 开发
+
+```
+npm install
+npm run dev        # http://localhost:5174/m/
+```
+
+## 生产
+
+```
+npm run build      # 输出到 dist/
+```
+
+Nginx 挂载示例：
+
+```
+location /m/ {
+    alias /path/to/frontend-h5/dist/;
+    try_files $uri $uri/ /m/index.html;
+}
+```
+
+API 仍走主站 `/api/`。