bud.js

Frontend build tools combining the best parts of Symfony Encore and Laravel Mix

---

What is bud.js?

bud.js is a web-focused build tool with add-on support for Babel, React, PostCSS, Sass, Typescript, esbuild, ESLint, Prettier, and more.

bud.js is written in TypeScript but fully supports projects written in vanilla JavaScript.

Goals

bud.js wants to be:

• Reliable, yielding consistent and predictable behaviors regardless of specified options.
• Fast, leveraging parallel processing, smart caching and an asyncronous events based API to keep build times minimal.
• Extensible, with a fully featured plugin system to support an ecosystem of packaged modules
• Simple, to get started and straight forward to maintain

Features

• Zero config by default. Check out this codesandbox template with react, postcss modules and no config.
• Modular by design. Use only what you need.
• Multi-compiler support.
• Heckin’ fast.
• Lux developer tooling and semi-automated dependency management.
• Support for configuration files authored with TypeScript, JSON, YML, CJS and ESM.
• Support for CDNs like skypack and unpkg. See documentation on using remote sources or this example sandbox using skypack modules
• Customizable and extensible. Add new features. Swap our core components with your own.

Requirements

• Node 16+
• yarn 1.22 or higher
• npm 8.3 or higher
• Windows users must run bud.js under the Windows Subsystem for Linux.

Getting started

Check out the Getting Started guide. There are many example implementations available in the /examples directory of this repo.

Modules

Presets

Name	Usage	Latest
@roots/bud-preset-recommend	📚 Usage
@roots/bud-preset-wordpress	📚 Usage
@roots/sage	📚 Usage

Extensions

Name	Usage	Latest
@roots/bud-babel	📚 Usage
@roots/bud-compress	📚 Usage
@roots/bud-criticalcss	📚 Usage
@roots/bud-emotion	📚 Usage
@roots/bud-entrypoints	📚 Usage
@roots/bud-esbuild	📚 Usage
@roots/bud-eslint	📚 Usage
@roots/bud-imagemin	📚 Usage
@roots/bud-mdx	📚 Usage
@roots/bud-postcss	📚 Usage
@roots/bud-prettier	📚 Usage
@roots/bud-purgecss	📚 Usage
@roots/bud-react	📚 Usage
@roots/bud-sass	📚 Usage
@roots/bud-solid	📚 Usage
@roots/bud-stylelint	📚 Usage
@roots/bud-swc	📚 Usage
@roots/bud-tailwindcss	📚 Usage
@roots/bud-bud-tailwindcss-theme-json	📚 Usage
@roots/bud-terser	📚 Usage
@roots/bud-typescript	📚 Usage
@roots/bud-vue	📚 Usage
@roots/bud-wordpress-dependencies	📚 Usage
@roots/bud-wordpress-externals	📚 Usage
@roots/bud-wordpress-manifests	📚 Usage
@roots/bud-wordpress-theme-json	📚 Usage

Have you produced a bud.js extension and want to share it here? Please, create an issue sharing information about your project.

For more information on authoring your own extension consult the documentation and the source code of the extensions in this repository.

Packages

Also included in the bud monorepo are packages which are not specific to bud.js but are used by the framework. These packages could conceivably be used in other projects.

Name	Latest
@roots/blade-loader
@roots/browserslist-config
@roots/container
@roots/critical-css-webpack-plugin
@roots/dependencies
@roots/entrypoints-webpack-plugin
@roots/eslint-config
@roots/filesystem
@roots/merged-manifest-webpack-plugin
@roots/wordpress-dependencies-webpack-plugin
@roots/wordpress-externals-webpack-plugin
@roots/wordpress-hmr
@roots/wordpress-theme-json-webpack-plugin

Contributing

Contributions are welcome from everyone.

We have contribution guidelines to help you get started.

License

bud.js is licensed under MIT.

Community

Keep track of development and community news.

• Join us on Roots Slack by becoming a GitHub sponsor
• Participate on the Roots Discourse
• Follow @rootswp on Twitter
• Read and subscribe to the Roots Blog
• Subscribe to the Roots Newsletter

Sponsors

Bud is an open source project and completely free to use.

However, the amount of effort needed to maintain and develop new features and projects within the Roots ecosystem is not sustainable without proper financial backing. If you have the capability, please consider sponsoring Roots.