Title: @wordpress/readable-js-assets-webpack-plugin
Published: June 10, 2021
Last modified: April 14, 2026

---

# @wordpress/readable-js-assets-webpack-plugin

## In this article

 * [Installation](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#installation)
 * [Usage](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#usage)
    - [Webpack](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#webpack)
 * [Contributing to this package](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#contributing-to-this-package)

[ Back to top](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#wp--skip-link--target)

Generate a readable non-minified JS file for each `.min.js` asset.

The end result is that for each JS entrypoint, we get a set of readable and non-
minimized `.js` file and a minimized `.min.js`. This allows Gutenberg to follow 
the WordPress convention of adding a `.min.js` suffix to minimized JS files, while
still providing a readable and unminized files that play well with the WordPress
i18n machinery.

Consult the [webpack website](https://webpack.js.org) for additional information
on webpack concepts.

## 󠀁[Installation](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#installation)󠁿

Install the module

    ```bash
    npm install @wordpress/readable-js-assets-webpack-plugin --save-dev
    ```

**Note**: This package requires Node.js version with long-term support status (check
[Active LTS or Maintenance LTS releases](https://nodejs.org/en/about/previous-releases)).
It is not compatible with older versions.

## 󠀁[Usage](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#usage)󠁿

### 󠀁[Webpack](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#webpack)󠁿

Use this plugin as you would other webpack plugins:

    ```javascript
    // webpack.config.js
    const ReadableJsAssetsWebpackPlugin = require( '@wordpress/readable-js-assets-webpack-plugin' );

    module.exports = {
        // …snip
        plugins: [ new ReadableJsAssetsWebpackPlugin() ],
    };
    ```

**Note:**

 * Multiple instances of the plugin are not supported and may produced unexpected
   results;
 * It assumes your webpack pipeline is already generating a `.min.js` JS asset file
   for each JS entry-point.

## 󠀁[Contributing to this package](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-readable-js-assets-webpack-plugin/?output_format=md#contributing-to-this-package)󠁿

This is an individual package that’s part of the Gutenberg project. The project 
is organized as a monorepo. It’s made up of multiple self-contained software packages,
each with a specific purpose. The packages in this monorepo are published to [npm](https://www.npmjs.com/)
and used by [WordPress](https://make.wordpress.org/core/) as well as other software
projects.

To find out more about contributing to this package or Gutenberg as a whole, please
read the project’s main [contributor guide](https://github.com/WordPress/gutenberg/tree/HEAD/CONTRIBUTING.md).

First published

June 10, 2021

Last updated

April 14, 2026

Edit article

[ Improve it on GitHub: @wordpress/readable-js-assets-webpack-plugin ](https://github.com/WordPress/gutenberg/edit/trunk/packages/readable-js-assets-webpack-plugin/README.md)

[  Previous: @wordpress/react-i18n](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-react-i18n/)

[  Next: @wordpress/redux-routine](https://developer.wordpress.org/block-editor/reference-guides/packages/packages-redux-routine/)