Skip to content

Commit ff9b270

Browse files
committed
chore: update
1 parent bb8ef71 commit ff9b270

File tree

2 files changed

+11
-10
lines changed

2 files changed

+11
-10
lines changed

website/docs/en/guide/start/index.mdx

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,14 @@ Rslib provides a comprehensive set of build features for library development, in
1010
- **Declaration file generation**: Including isolated declarations.
1111
- **Advanced features**: Module Federation, asset compression, PostCSS, Lightning CSS, and more.
1212

13+
## 🚀 Why Rslib
14+
15+
In developing component or utility libraries, developers need to focus not only on implementing project logic but also on handling non-code tasks such as building, debugging, documentation, and testing. Many existing community tools and solutions can address some of these requirements; however, for developers who are not familiar with these tools, meeting these demands often involves tedious configuration or coordinating multiple tools.
16+
17+
Based on Rspack and Rsbuild, Rslib offers a comprehensive solution tailored to the diverse needs of library development. It effectively addresses issues like an underdeveloped tooling ecosystem, high costs for module standard compatibility, and insufficient output optimization. Rslib improves upon webpack's limited support for library ESM outputs, enabling the production of high-quality, tree-shakeable ESM builds. Additionally, Rslib fully capitalizes on the build performance advantages of Rspack and leverages the strengths of both the webpack and Rspack ecosystems to robustly support features such as Module Federation.
18+
19+
Furthermore, by sharing a unified configuration, Rslib resolves the challenge of reusing build configurations between application projects and library projects, thereby reducing configuration overhead and enhancing developer productivity and experience.
20+
1321
## 🔥 Features
1422

1523
Rslib has the following features:

website/docs/zh/guide/start/index.mdx

Lines changed: 3 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -12,18 +12,11 @@ Rslib 提供了丰富的构建功能,包括:
1212

1313
## 🚀 为什么选择 Rslib
1414

15-
在开发组件库或者工具库的过程中,开发者不仅需要关注项目逻辑的实现,还要考虑项目的构建、调试、文档、测试等等和代码逻辑无关的事情。社区中现有的许多工具与方案,它们通常都能很好地满足其中个别需求,但对于不熟悉这些工具与方案的开发者而言,往往需要繁琐的配置工作或同时使用多种工具配合来满足这些需求
15+
在开发组件库或工具库时,开发者不仅需要关注项目逻辑的实现,还需考虑项目的构建、调试、文档和测试等与代码逻辑无关的工作。现有许多社区工具与方案通常能较好地满足其中部分需求,但对于不熟悉这些工具与方案的开发者来说,往往需要繁琐的配置工作或多种工具配合使用,以满足这些需求
1616

17-
同时,我们在实践中发现,目前库开发主要面临以下痛点:
17+
Rslib 基于 Rspack 与 Rsbuild 实现,针对库开发场景的多样化需求,提供了一套完整的解决方案,有效解决了库开发中的工具生态不完善、模块规范兼容成本高、产物优化不足等问题。Rslib 对 webpack 对 library ESM 产物支持不足的情况进行了优化,可以产出支持 tree-shaking 的高质量 ESM 产物。同时,Rslib 充分发挥了 Rspack 带来的构建性能优势,并利用 webpack / Rspack 生态的优势,很好地支持了模块联邦等功能。
1818

19-
- **工具生态不完善**:例如 esbuild 生态无法支持模块联邦功能,webpack 对 library ESM 产物的支持也存在不足。
20-
- **模块规范兼容性问题**:对 ESM、CJS、UMD 等多种模块规范的支持,显著增加了兼容性和互操作性的开发成本。
21-
- **产物优化不足**:库产物在 tree-shaking 和代码分割等方面的优化效果欠佳。
22-
- **构建性能瓶颈**:部分工具因架构限制而存在明显的性能问题。
23-
- **配置复用性差**:应用项目与库项目的构建配置难以复用与共享,导致不一致的开发体验和较高的维护成本。
24-
- **开发流程割裂**:库调试、文档和测试等环节缺乏统一的解决方案,与核心开发流程产生割裂。
25-
26-
Rspack / Rsbuild 的不断迭代与发展让我们看到了解决这些问题的可能。Rslib 在它们的基础上进行了一系列工作,利用 webpack / Rspack 生态的优势,为库开发场景提供了一套开箱即用的解决方案,在构建性能、模块规范兼容性、产物优化等方面都取得了显著的成效。同时,Rslib 通过统一的配置和完善的功能生态,能够串联起整个库开发流程,从而大幅降低开发者的配置成本,提高开发效率与体验。
19+
此外,Rslib 可以通过共享一套统一的配置,解决应用项目与库项目之间构建配置难以复用的问题,进而降低开发者的配置成本,提升开发效率与体验。
2720

2821
## 🔥 特性
2922

0 commit comments

Comments
 (0)