KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

next-bundle-analyzer

★ 37 Open GitHub ↗

NextJS version of Webpack Bundle Analyzer.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Next Bundle Analyzer

## Motivation

[Webpack Bundle Analyzer](https://github.com/webpack-contrib/webpack-bundle-analyzer)
is a great tool to analyze the bundles of web applications built on top of
[Webpack](https://github.com/webpack/webpack) but trying to use it to optimize a
large website with many pages can be tricky because you don't know which pages
the different chunks belong to.

There is an official wrapper dedicated to Next.js,
[@next/bundle-analyzer](https://github.com/vercel/next.js/tree/canary/packages/next-bundle-analyzer),
but it only allows (for now) to generate standard reports for the server and
client builds of Next.

This library generates customized Webpack Bundle Analyzer reports in order to
make them easier to use for Next users.

![Demo](https://raw.githubusercontent.com/josselinbuils/next-bundle-analyzer/master/demo.gif)

## Installation

We recommend installing `next-bundle-analyzer` as dev dependency:

```bash
npm install -D next-bundle-analyzer
```

```bash
yarn add -D next-bundle-analyzer
```

## Usage

```js
// next.config.js

const shouldAnalyzeBundles = process.env.ANALYZE === true;

let nextConfig = {
  // [...]
};

if (shouldAnalyzeBundles) {
  const withNextBundleAnalyzer =
    require('next-bundle-analyzer')(/* options come there */);
  nextConfig = withNextBundleAnalyzer(nextConfig);
}

module.exports = nextConfig;
```

⚠️ If `next-bundle-analyzer` has been installed as dev dependency, itshould be
required conditionally to prevent breaking Next.js in production.

## Options

### Root options

| Option         | Values                                               | Default                                                                                         | Description                                                                           |
| -------------- | ---------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| clientOnly     | `true` `false`                                       | `true`                                                                                          | When `true`, generate only a report for client side build.                            |
| enabled        | `true` `false`                                       | `true`                                                                                          | Allows to enable/disable the plugin.                                                  |
| format         | `'html'` `'json'` <code>['html',&nbsp;'json']</code> | `'html'`                                                                                        | The format of the report(s) to generate. It can be a single format or a list.         |
| html           | See [HTML options](#html-options).                   | `{}`                                                                                            | Options related to the HTML report.                                                   |
| json           | See [JSON options](#json-options).                   | `{}`                                                                                            | Options related to the JSON report.                                                   |
| reportDir      | `string`                                             | `'analyze'`                                                                                     | Name of the directory that will contain the reports. Relative to Webpack output path. |
| reportFilename | `string`                                             | `'bundles'`<br><br>`'-client'` and `'-server'` suffixes will be added if `clientOnly` is false. | Name of the report without the extension.                                             |

### HTML options

| Option | Values         | Default | Description                                             |
| ------ | -------------- | ------- | ------------------------------------------------------- |
| open   | `true` `false` | `true`  | When `true`, report opens automatically once generated. |

### JSON options

| Option | Values                                                                                                   | Default | Description                                                         |
| ------ | -------------------------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------- |
| filter | Object with the same structure than the JSON report to filter.<br><br>Use `true` as value to keep a key. | `null`  | Filter to apply to the JSON report in order to keep only some keys. |

next-bundle-analyzer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README