Awesome
<picture> <img alt="Rslib Banner" src="https://assets.rspack.dev/rslib/rslib-banner.png"> </picture>Rslib
<p> <a href="https://discord.gg/FQfm7VqU"><img src="https://img.shields.io/badge/chat-discord-blue?style=flat-square&logo=discord&colorA=564341&colorB=F8F5FF" alt="Discord channel" /></a> <a href="https://npmjs.com/package/@rslib/core?activeTab=readme"><img src="https://img.shields.io/npm/v/@rslib/core?style=flat-square&colorA=564341&colorB=F8F5FF" alt="npm version" /></a> <a href="https://npmcharts.com/compare/@rslib/core?minimal=true"><img src="https://img.shields.io/npm/dm/@rslib/core.svg?style=flat-square&colorA=564341&colorB=F8F5FF" alt="downloads" /></a> <a href="https://nodejs.org/en/about/previous-releases"><img src="https://img.shields.io/node/v/@rslib/core.svg?style=flat-square&colorA=564341&colorB=F8F5FF" alt="node version"></a> <a href="https://github.com/web-infra-dev/rslib/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square&colorA=564341&colorB=F8F5FF" alt="license" /></a> </p>Rslib is a library development tool that leverages the well-designed configurations and plugins of Rsbuild, empowering library developers to take advantage of the extensive knowledge and ecosystem of webpack and Rspack.
Rslib provides a comprehensive set of build features for library development, including:
- Compilation of diverse languages: TypeScript, JSX, Sass, Less, CSS Modules, Wasm, and more.
- Flexible build modes: Bundle and bundleless options to meet varying needs.
- Multiple output formats: ESM, CJS, and UMD for maximum compatibility.
- Declaration file generation: Including isolated declarations.
- Advanced features: Module Federation, asset compression, PostCSS, Lightning CSS, and more.
✨ Why Rslib?
In the past, we typically did not use webpack or Rspack to build ESM packages because they often included excessive runtime code, making them less friendly to package consumers. However, the community has developed a vast ecosystem around webpack and Rspack, which provides powerful features like tree shaking, code splitting, module federation and more.
So we decided to create Rslib. It improves the quality of ESM output from Rspack and webpack, leverages their extensive ecosystem, and utilizes Rsbuild's excellent out-of-the-box configuration. Rslib aims to provide a superior developer experience and explore new possibilities based on the Rspack architecture.
📍 Roadmap
🚧 Rslib is still in its early stages and under active development. We are building Rslib by working in two main parts:
- bundler support track: Improve the quality of ESM / CJS outputs by contributing to Rspack and webpack.
- Rslib features track: Develop the core features of Rslib.
You can click the link above to check the progress of these tasks. The roadmap may change as we move forward.
We plan to complete the core features of Rslib in Q3 2024 and use Rslib to build our npm packages such as Rspack and Rsbuild (dogfooding). And Rslib will have a public stable version in Q4 2024.
If you're interested in Rslib, feel free to submit issues or pull requests to help us get there faster.
You can also clone the repository and run the examples in the examples folder to experience Rslib.
🦀 Links
- Rspack: A fast Rust-based web bundler.
- Rsbuild: A high-performance build tool powered by Rspack.
- Rspress: A fast static site generator based on Rsbuild.
- Rsdoctor: A one-stop build analyzer for Rspack and Webpack.
- Modern.js: A progressive React framework based on Rsbuild.
- awesome-rspack: A curated list of awesome things related to Rspack and Rsbuild.
- rspack-examples: Examples for Rspack, Rsbuild, Rspress and Rsdoctor.
- storybook-rsbuild: Storybook builder powered by Rsbuild.
- rsbuild-plugin-template: Use this template to create your own Rsbuild plugin.
- rstack-design-resources: Design resources for Rspack, Rsbuild, Rspress and Rsdoctor.
🤝 Contribution
New contributors welcome!
Please read the Contributing Guide.
Contributors
<a href="https://github.com/web-infra-dev/rslib/graphs/contributors" target="_blank"> <table> <tr> <th colspan="2"> <br/> <img src="https://contrib.rocks/image?repo=web-infra-dev/rslib&columns=16&max=96"><br/><br/> </th> </tr> </table> </a>Code of Conduct
This repo has adopted the ByteDance Open Source Code of Conduct. Please check Code of Conduct for more details.
🧑💻 Community
Come and chat with us on Discord! The Rstack team and users are active there, and we're always looking for contributions.
🌟 Quality
Rslib uses Web Infra QoS to observe the trend of key metrics, such as bundle size, compile speed and install size.
🙏 Credits
Some of the implementations of Rslib have drawn inspiration from outstanding projects in the community. We would like to express our gratitude to them:
- esbuild, created by Evan Wallace.
- tsup, created by EGOIST.
📖 License
Rslib is licensed under the MIT License.