Skip to content

Latest commit

 

History

History
108 lines (78 loc) · 3.29 KB

README.zh-CN.md

File metadata and controls

108 lines (78 loc) · 3.29 KB

license npm NPM downloads Percentage of issues still open

English | 简体中文

最好用的 JS|TS 第三方库脚手架,10 秒快速搭建一个新库的基础框架

基于 jslib-base 的库,都可以分享到jsmini平台

⭐ 特性

  • 支持快速新建和无缝升级的命令行工具
  • 支持 ES6+或 TypeScript 编写源码,编译生成生产代码
  • 第三方依赖自动注入(自动剔除第三方依赖无用代码 tree shaking)
  • 多环境支持(支持浏览器原生,支持 AMD,commonjs,支持 Webpack,Rollup,vite, fis 等,支持 Node.js)
  • 集成代码风格校验(eslint + prettier + husky)
  • 集成单元测试环境(mocha)
  • 集成测试覆盖率(istanbul+nyc)
  • 集成可持续构建工具 github action
  • 集成jsmini

🚀 使用者指南

新建一个项目,推荐使用 Node.js 16 及以上版本。

$ npx @js-lib/cli new mylib
# 交互式询问,输入项目信息
$ cd mylib
$ npm i

更新项目,只需在项目根目录执行如下命令

$ npx @js-lib/cli update

对于旧项目,不能直接执行 update 命令,可以先初始化一个配置文件

$ npx @js-lib/cli new -c

目录简介

.
├── demo 使用demo
├── dist 编译产出代码
├── doc 项目文档
├── src 源代码目录
├── test 单元测试
├── CHANGELOG.md 变更日志
└── TODO.md 计划功能

常用命令脚本

$ npm run lint # 校验代码
$ npm run test # 运行单测
$ npm run build # 构建代码
$ npm run release # 发布代码
$ npm publish # 发布到npm

😘 贡献者指南

本项目使用 lerna 来管理多个插件,lerna 常用命令如下:

$ npx lerna init # 初始化
$ npx lerna create @js-lib/todo # 创建一个package
$ npx lerna add yargs --scope=@js-lib/cli # 给package安装依赖
$ npx lerna list # 列出所有的包
$ npx lerna bootstrap # 安装全部依赖
$ npx lerna link # 建立全部软连接
$ npx lerna changed # 列出下次发版npx lerna publish 要更新的包
$ npx lerna publish # 会打tag,上传git,上传npm

贡献者列表

contributors

⚙️ 更新日志

CHANGELOG.md

✈️ 计划列表

TODO.md

💡 谁在使用

参考文档