diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4b68a87
--- /dev/null
+++ b/README.md
@@ -0,0 +1,1230 @@
+# First UI 快速上手
+
+使用 First UI 前,请确保你已经学习并熟练使用过 [uni-app](https://uniapp.dcloud.io/) 。
+
+
+### 安装
+
+#### 方式一 :通过 npm 安装
+
+
使通过 npm 安装,需要先通过 vue-cli 创建 uni-app 项目,
详见 。
+
+``` js
+// # Using npm
+npm install firstui-uni
+```
+
+#### 方式二 :通过下载代码
+
+通过
GitHub 或者
FirstUI官网(VIP) 下载 First UI 的代码,然后 将 components/firstui/ 目录拷贝到自己的项目中。
+
+``` js
+// # GitHub
+git clone https://github.com/FirstUI/FirstUI.git
+```
+
+#### 方式三 :选择需要的模块引入
+
+
+
第二种:easycom组件规范
+
传统vue组件,需要安装、引用、注册,三个步骤后才能使用组件。easycom将其精简为一步,如果不了解easycom,可先查看
官网文档 。
+
+在 `pages.json` 中 添加配置:
+
+``` js
+// 下载安装时配置
+"easycom": {
+ "autoscan": true,
+ "custom": {
+ "fui-(.*)": "@/components/firstui/fui-$1/fui-$1.vue"
+ }
+ }
+
+// 使用npm安装时配置(配置完成后重新编译运行)
+"easycom": {
+ "autoscan": true,
+ "custom": {
+ "fui-(.*)": "firstui-uni/firstui/fui-$1/fui-$1.vue"
+ }
+ }
+```
+
+
+
+### 使用组件
+
+引入组件后,可以在 页面 中直接使用组件
+
+``` html
+