# bkui-vue

> ![bkui-vue3](docs/logo.png) ---

Latest version **3.0.9** (published 2026-09-20) · 0 weekly downloads

## Install

```sh
npm install bkui-vue
pnpm add bkui-vue
yarn add bkui-vue
bun add bkui-vue
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 3.0.9 |
| Published | 2026-09-20 |
| First published | 2021-05-06 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | blueking-magicbox |

## Links

- npm: https://www.npmjs.com/package/bkui-vue
- npm.io page: https://npm.io/package/bkui-vue

## Recent versions

- 3.0.9 (latest) — 2026-09-20
- 3.0.3 (release-3.0.3) — 2026-06-22
- 3.0.2 (release-3.0.2) — 2026-06-16
- 3.0.1 (release-3.0.1) — 2026-06-03
- 2.1.0-dev-beta.17 (dev_2.1.0) — 2026-05-22
- 2.1.0-beta.11 (beta) — 2026-05-13
- 2.1.0-dev-beta.5 (dev-2.1.0) — 2026-04-09
- 2.1.0-dev-beta.1 (2.1.0_dev) — 2026-03-17
- 2.0.2-beta.112 (dev-2.0.3) — 2026-03-16
- 2.0.2-beta.111 (dev-2.3.0) — 2026-03-12
- 2.0.2-beta.104 (beta-2.3.0-dev) — 2026-03-09
- 2.0.2-beta.102 (dev_2.3.0) — 2026-03-02
- 2.0.1-beta.106 (tootips-beta) — 2025-04-01
- 2.0.1-beta.72.fix.2 (beta60fix) — 2024-11-20
- 2.0.1-beta.70.search.1 (staging-1.x) — 2024-09-23
- … 931 more at https://npm.io/package/bkui-vue/versions

## README

![bkui-vue3](docs/logo.png)
---

[![license](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](https://github.com/TencentBlueKing/bkui-vue3/blob/master/LICENSE.txt) [![Release Version](https://img.shields.io/npm/v/bkui-vue.svg)](https://www.npmjs.com/package/bkui-vue) <!--[![month dowloads](http://img.shields.io/npm/dm/bkui-vue.svg)](https://npmcharts.com/compare/bkui-vue?minimal=true)--> [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/TencentBlueKing/bkui-vue3/pulls)

[English](README_EN.md) | 简体中文

# bkui-vue3

基于蓝鲸 Magicbox 和 Vue3 的前端组件库

## Project setup

```
yarn install
```

### Compiles and hot-reloads for development

```
yarn dev
```

### Compiles and minifies for production

```
yarn build
```

### Run your unit tests

```
yarn test
```

### Lints and fixes files

```
yarn lint
```

#### 如何新增使用一个 icon

* 将你的 svg 保存到 `packages/icon/src/svg` 目录下
* 重命名为你的 icon 使用的具有识别的英文名称
* 执行命令 `yarn generate:icon`
* 在组件中使用类似语法 `import { HelpFill } from '@bkui-vue/icon/';` 引用即可

## 容器化

想要快速的通过容器化方式启动,可以参照以下步骤，快速在容器化服务器上进行部署启动。

```
# 本地镜像打制
docker build -t bkui-vue3 .

# 容器化运行
docker run -p 8086:8086 bkui-vue3

# 开发调试
docker run -it -p 8086:8086 -v $(pwd):/app bkui-vue3
```

## 如何开始

想要贡献代码，建议请先参照已有的特性文档和开发环境构建文档。可以运行 `yarn cc` 输入组件名生成新组件模板

## GIT 提交规范

为了规范 commit-msg 格式，建议使用 `yarn cz` 自动生成 commit-msg, 不同的提交标记以规范化区分提交内容：

```
<标记>(<组件名称>): [提交的概要注释] issue #[123]
// 空一行
<本次变更详细说明>
// 空一行
<footer>
```

示例:

```shell
chore(common): 梳理组件库开发流程

affects: bkui-vue, @bkui-vue/button, @bkui-vue/checkbox, @bkui-vue/input, @bkui-vue/radio

允许单个组件执行 jest 任务
添加 husky 提交流程较验
添加 chanelog 自动生成机制

ISSUES CLOSED: #1
```

### 标记说明

| 标记           | 说明                                        |
| -------------- | ------------------------------------------- |
| feature/feat   | 新功能开发                                  |
| bug/fix/bugfix | bug 修复                                     |
| refactor/perf  | 重构代码/优化配置&参数/优化逻辑及功能       |
| test           | 添加单元测试用例相关                        |
| docs           | 添加文档                                    |
| info           | 添加注释类信息                              |
| format         | 不修改业务逻辑下，仅做代码规范的格式化      |
| merge          | 仅做分支合并同步                            |
| depend         | 对工程的依赖进行增删改                      |
| chore          | 构建脚本、任务等相关代码                    |
| del            | 删除可能仍然有人用到的功能、API 等破坏性动作 |

---
_Source: https://npm.io/package/bkui-vue · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
