116 lines
5.2 KiB
Markdown
116 lines
5.2 KiB
Markdown
<p style="display:flex; justify-content: center">
|
||
|
||
</p>
|
||
<p align="center">
|
||
<a href="https://tdesign.tencent.com/starter/vue/#/dashboard/base" target="_blank">
|
||
<img alt="TDesign Logo" width="200" src="https://tdesign.gtimg.com/starter/brand-logo.svg">
|
||
</a>
|
||
</p>
|
||
|
||
<p align="center">
|
||
<a href="https://nodejs.org/en/about/releases/"><img src="https://img.shields.io/node/v/vite.svg" alt="node compatility"></a>
|
||
<a href="https://github.com/Tencent/tdesign-vue/blob/develop/LICENSE">
|
||
<img src="https://img.shields.io/npm/l/tdesign-vue.svg?sanitize=true" alt="License">
|
||
</a>
|
||
</p>
|
||
|
||
简体中文 | [English](./README.md)
|
||
|
||
### 项目简介
|
||
|
||
TDesign Vue Starter 是一个基于 tdesign-vue，使用 `Vue2`、`Vite`开发，可进行个性化主题配置，旨在提供项目开箱即用的、配置式的中后台项目。
|
||
|
||
<p>
|
||
<a href="http://tdesign.tencent.com/starter/vue/">在线预览</a>
|
||
·
|
||
<a href="https://tdesign.tencent.com/starter/docs/vue/get-started">使用文档</a>
|
||
|
||
</p>
|
||
|
||
<img src="docs/docs-starter.png">
|
||
|
||
### 特性
|
||
|
||
- 内置多种常用的中后台页面
|
||
- 完善的目录结构
|
||
- 完善的代码规范配置
|
||
- 支持暗黑模式
|
||
- 自定义主题颜色
|
||
- 多种空间布局
|
||
- 内置 Mock 数据方案
|
||
|
||
### 使用
|
||
|
||
> 通过 [tdesign-starter-cli](https://www.npmjs.com/package/tdesign-starter-cli) 初始化项目仓库
|
||
|
||
```bash
|
||
## 1、安装 tdesign-starter-cli
|
||
npm i tdesign-starter-cli@latest -g
|
||
|
||
## 2、创建项目
|
||
td-starter init
|
||
```
|
||
|
||
### 开发
|
||
|
||
```bash
|
||
## 安装依赖
|
||
npm install
|
||
|
||
## 启动项目
|
||
npm run dev
|
||
```
|
||
|
||
### 构建
|
||
|
||
```bash
|
||
## 构建正式环境
|
||
npm run build
|
||
|
||
## 构建测试环境
|
||
npm run build:test
|
||
```
|
||
|
||
### 其他
|
||
|
||
```bash
|
||
## 预览构建产物
|
||
npm run preview
|
||
|
||
## 代码格式检查
|
||
npm run lint
|
||
|
||
## 代码格式检查与自动修复
|
||
npm run lint:fix
|
||
|
||
## style格式检查
|
||
npm run stylelint
|
||
|
||
## style格式检查与自动修复
|
||
npm run stylelint:fix
|
||
```
|
||
|
||
### 如何贡献
|
||
|
||
非常欢迎您的贡献！提交您的 [Issue](https://github.com/tencent/tdesign-vue-starter/issues/new/choose) 或者提交 [Pull Request](https://github.com/Tencent/tdesign-vue-starter/pulls)。
|
||
|
||
#### 贡献提交规范
|
||
|
||
- [Angular Convention](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular)
|
||
- [Vue Style Guide](https://v3.vuejs.org/style-guide/#rule-categories)
|
||
|
||
### 兼容性
|
||
|
||
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br> IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari |
|
||
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||
| Edge >=84 | Firefox >=83 | Chrome >=84 | Safari >=14.1 |
|
||
|
||
### 社区版本
|
||
|
||
基于 TDesign Vue 的 starter-kit 有多种社区版本，访问 [社区链接](https://tdesign.tencent.com/starter/docs/vue/community-link) 可以访问更多版本。
|
||
如果您也开发了 TDesign Starter 的社区版本，可以提交 Issue 或者直接给我们提Pull Request 😊。
|
||
|
||
### 开源协议
|
||
|
||
TDesign 遵循 [MIT 协议](https://github.com/Tencent/tdesign-vue-starter/LICENSE)。
|