close
Rslib
  • 简体中文

      • 快速上手

      环境准备

      Rslib 支持使用 Node.js、Deno 或 Bun 作为 JavaScript 运行时。

      你可以参考以下安装指南，选择其中一种运行时：

      版本要求
      • Rslib >= 0.20 要求 Node.js 版本 20.19+，22.12+。
      • Rslib < 0.20 要求 Node.js 18.12.0 或更高版本。

      创建 Rslib 项目

      使用 create-rslib 来创建一个 Rslib 项目，运行以下命令：

      npm
      yarn
      pnpm
      bun
      deno
      npm create rslib@latest

      按照提示一步步操作即可。在创建过程中，你可以选择模板、语言、可选工具，以及供 Coding Agents 使用的可选技能。

      创建的 Rslib 项目默认使用 Rstest 作为测试框架，阅读 使用 Rstest 了解更多信息。

      在创建完成后，你可以执行以下步骤：

      • 执行 git init 来初始化 Git 仓库。
      • 执行 npm install（或其他包管理器的 install 命令）安装 npm 依赖。
      • 执行 npm run dev 启动监听模式开始开发。

      模板

      在创建项目时，你可以选择 create-rslib 提供的下列模板：

      模板描述
      Node.js dual ESM/CJS packageNode.js 双格式 ESM/CJS 包
      Node.js pure ESM packageNode.js 纯 ESM 包
      ReactReact 组件库
      VueVue 组件库
      SvelteSvelte 组件库

      可选工具

      create-rslib 能够帮助你设置以下常用工具，你可以使用上下箭头和空格进行选择。如果你不需要这些工具，可以直接按回车跳过。

      工具用途
      ESLint代码检查
      Rslint代码检查
      Prettier代码格式化
      Biome代码检查和格式化
      Rspress组件文档，仅 React + TypeScript 模板
      Storybook组件开发和预览，仅 React 和 Vue 模板
      React Compiler优化 React 组件，仅 React 模板

      可选技能

      create-rslib 可以为支持 Skills 的 Coding Agents 安装可选技能。在交互模式下，“可选工具”的选择会影响可选技能的结果。目前提供的技能有：

      名称条件
      rslib-best-practices默认显示
      rstest-best-practices默认显示
      rspress-custom-theme选择 Rspress
      rspress-description-generator选择 Rspress

      你可以使用上下箭头和空格进行选择。如果不需要这些技能，可以直接按回车跳过。

      ◆  Select optional skills (Use <space> to select, <enter> to continue)
│  ◻ Rslib - best practices
│  ◻ Rstest - best practices

      关于 Agent Skills 和其他 AI 相关能力的更多介绍，可参考 AI。

      当前目录

      如果你需要在当前目录下创建项目，可以将 target folder 设置为 .：

      ◆  Create Rslib Project
│
◇  Project name or path
│  .
│
◇  "." is not empty, please choose:
│  Continue and override files

      非交互模式

      create-rslib 支持通过命令行选项进入非交互模式。使用该模式可以跳过所有提示，直接创建项目，适合脚本、CI 以及 coding agents 等自动化场景。

      例如，以下命令将在 my-project 目录中创建一个 React 项目：

      npx -y create-rslib@latest my-project --template react

# 使用缩写
npx -y create-rslib@latest my-project -t react

# 指定多个 tools
npx -y create-rslib@latest my-project -t react --tools storybook,biome

# 为 Coding Agents 安装可选 skill
npx -y create-rslib@latest my-project -t react --skill rslib-best-practices

      create-rslib 完整的 CLI 选项如下：

      Usage: create-rslib [dir] [options]

Options:

  -h, --help            display help for command
  -d, --dir <dir>       create project in specified directory
  -t, --template <tpl>  specify the template to use
  --tools <tool>        add additional tools, comma separated
  --skill <skill>       add optional skills, comma separated
  --override            override files in target directory
  --packageName <name>  specify the package name

Available templates:
  node-dual-js, node-dual-ts, node-esm-js, node-esm-ts, react-js, react-ts, vue-js, vue-ts, svelte-js, svelte-ts

Optional tools:
  react-compiler, eslint, rslint, biome, prettier, rspress, storybook

Optional skills:
  rslib-best-practices, rstest-best-practices, rspress-custom-theme, rspress-description-generator

      从现有项目迁移

      如果你需要从一个现有项目迁移迁移到 Rslib，可以参考以下指南：

      其他项目

      对于其他类型的项目，你可以手动安装 @rslib/core 包：

      npm
      yarn
      pnpm
      bun
      deno
      npm add @rslib/core -D

      然后参考指南和文档，按需启用各个功能：