Provides debug and build capabilities for pilets and Piral instances using esbuild.
npm install piral-cli-esbuild
This plugin enables using esbuild as the bundler for Piral instances and pilets.
Use your favorite npm client for the installation:
``sh`
npm i piral-cli-esbuild --save-dev
Note: The plugin has to be installed to tell the piral-cli to use esbuild as the default bundler.
There is nothing to do. Standard commands such as piral build or pilet debug will now work with esbuild as the bundler.
This plugin comes with batteries included. You don't need to install or specify your esbuild version.
Right now it includes:
- esbuild-sass-plugin
-
Additionally, most known referenced assets are handled as files.
If you want to customize the given config (e.g., to add more plugins) then create a file esbuild.config.js in your root directory.
In the most trivial version the file looks as follows:
`js`
module.exports = function(options) {
return options;
};
This would just receive the original build options and return them, i.e., essentially not doing anything. If you want to add some plugin you could do:
`js
const { somePlugin } = require('esbuild-some-plugin');
module.exports = function(options) {
options.plugins.push(somePlugin());
return options;
};
``
There are no overrides applied afterwards. Therefore, what you modify will remain in the options.
Piral is released using the MIT license. For more information see the license file.