luckly-cli

开箱即用的 Vue3组件库 快速成型工具，提供了一系列命令和工具去解决组件库开发上的问题 本项目是阅读 varlet/cli 脚手架源码后的仿写学习，根据自己的开发需求简化了很多内容，但是大部分的配置字段依然仿照 varlet/cli 脚手架的功能与配置

特性

• 📦  开箱即用的组件库开发环境
• 🛠️  基于配置文件的组件库文档站点
• 🛠️  支持 sfc 和 tsx 两种风格的组件库编写风格
• 📦  开箱即用的代码检查工具
• 📦  开箱即用的代码发布工具
• 💪  支持 Typescript
• 🌍  支持 国际化
• 🚀  基于 pnpm

快速开始

luckly-cli 内置了 sfc 和 tsx 两种风格的组件库项目模板，可以通过 gen 命令直接生成。 方便您直接进入组件库开发。

# 安装命令行工具
pnpm add luckly-cli -g
luckly-cli gen

然后通过简单修改一些组件库模板的基础信息，就可以开始组件库的开发了

配置文件

项目根目录下的 varlet.config.mjs 用来管理整个组件库项目的具体细节。 默认配置可查阅 varlet.default.config.ts。 也可以参考 @varlet/ui 的 varlet.config.mjs

参数	说明	类型	默认值
name	组件库全名，会作为包名	string	Varlet
namespace	组件库命名空间, 会作为组件前缀	string	luckly
host	开发服务器主机	string	localhost
port	开发服务器端口	number	8080
title	文档中组件库的标题	string	VARLET
logo	文档中组件库的logo	string	-
defaultLanguage	文档默认语言	string	zh-CN
lightTheme	亮色模式文档主题	Record<string, any>	-
darkTheme	暗黑模式文档主题	Record<string, any>	-
highlight	文档代码片段样式相关	{ style: string }	-
pc	pc端文档结构配置	Record<string, any>	-

命令相关

启动开发服务器

生成一个项目模板

luckly-cli gen

```shell
luckly-cli dev

构建文档站点

luckly-cli build

构建组件库代码

luckly-cli compile

发布组件库

luckly-cli release

Options

-n --name 项目名 -s --sfc 生成 sfc 风格的项目模板 -t --tsx 生成 tsx 格式项目 -l --locale 需要支持国际化

#### 创建组件模板文件

```shell
luckly-cli create

# Options
-n
--name
  组件名
-s
--sfc
  生成 sfc 风格的组件
-t
--tsx
  生成 tsx 风格的文件
-l
--locale
  需要支持国际化

发布前注意

1. npm 的仓库源必须指向 npm 官方镜像
2. 执行 npm login 进行登录