zp342519261 / tesla-vue-components

vue 组件库

组件库模版

基于Vue3,VitePress, Rollup，Gulp等主流技术开发的组件库模板。内置打包组件、Hooks、Utils，可按需引入，支持TypeScript，让所有注意力都能放在文档编写和组件开发上。内置VitePress主题，免去写样式的烦恼，自带夜间模式，可自定义主题

特性

• 最新技术栈：使用 Vue3/Rollup/Gulp 等前端前沿技术开发
• 组件文档：使用 VitePress 内置文档
• 支持：支持 TypeScript，支持按需引入
• 模板： 内置指令一键生成开发模板
• 组件打包：内置Esm、Commonjs打包模式，支持按需引入
• 规范：内置Eslint、StyleLint、Prettier统一规范

准备

• Node 和 Git -项目开发环境
• Vite - 熟悉 Vite 特性
• Vue3 - 熟悉 Vue 基础语法
• Es6+ - 熟悉 Es6 基本语法
• VitePress - 熟悉 VitePress 基本使用

安装使用

• 获取项目代码（https or ssh）

git clone https://github.com/zp342519261/tesla-vue-components.git

git clone [email protected]:zp342519261/tesla-vue-componentsgit

• 安装依赖

npm install

# 建议不要直接使用 cnpm 安装以来，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
# 如果下载依赖慢可以使用淘宝镜像源安装依赖
npm install --registry=https://registry.npm.taobao.org

Developer

• 运行内置模板调试组件

npm run dev

• 运行 VitePress 文档

npm run docs:dev

• 创建组件模板

npm run ct '组件名称'

Production

• 打包组件库

npm run build

• 打包 VitePress 文档

npm run docs:build

Git 提交规范

• 参考 vue 规范

  • feat 新增功能
  • fix 修复缺陷
  • docs 文档变更
  • style 代码格式
  • refactor 代码重构
  • perf 性能优化
  • test 添加疏漏测试或已有测试改动
  • build 构建流程、外部依赖变更 (如升级 npm 包、修改打包配置等)
  • ci 修改 CI 配置、脚本
  • revert 回滚 commit
  • chore 对构建过程或辅助工具和库的更改 (不影响源文件)
  • wip 正在开发中
  • types 类型定义文件修改

• 或使用指令提交

npm run cz

规范相关

• EsLint - js 语法检测
• StyleLint - 样式语法检测
• CommitLint - git commit 提交规范检测

目录

.
├── LICENSE
├── README.md
├── build
├── commitlint.config.js
├── docs                                # vitepress文档目录
├── effect                              # 调试模板
├── lib
├── node_modules
├── package-lock.json
├── package.json
├── packages                            # 公共组件目录
│   ├── components                      # 组件存放目录
│   ├── hooks                           # hooks存放目录
│   ├── theme-default                   # 组件样式存放目录
│   ├── utils                           # 公共方法存放目录
├── postcss.config.js
├── prettier.config.js
├── script
├── stylelint.config.js
├── tsconfig.json
└── typings

感谢以下优秀的项目提供帮助

• Element-Plus
• Naive-UI

License

MIT © 2022