Vite Bundle Analyzer

A bundle analyzer for Vite, Rollup, and Rolldown that visualizes bundle size with an interactive treemap.

[!WARNING] Vite enables minification by default. The parsed size may appear larger than actual size because bundle info from Rollup isn't compressed. Rolldown support is experimental.

Installation

npm install vite-bundle-analyzer -D
# or
yarn add vite-bundle-analyzer -D
# or
pnpm add vite-bundle-analyzer -D

Usage

Vite

import { defineConfig } from 'vite'
import { analyzer } from 'vite-bundle-analyzer'

export default defineConfig({
  plugins: [
    analyzer()
  ]
})

Rollup

import { adapter } from 'vite-bundle-analyzer'
import { analyzer } from 'vite-bundle-analyzer'

export default {
  plugins: [
    adapter(analyzer())
  ]
}

Rolldown

import { unstableRolldownAdapter } from 'vite-bundle-analyzer'
import { analyzer } from 'vite-bundle-analyzer'

export default {
  plugins: [
    unstableRolldownAdapter(analyzer())
  ]
}

Configuration

CLI

npx vite-bundle-analyzer

# With options
npx vite-bundle-analyzer --help

Common Issues

Empty Chunk Sizes

If chunk sizes appear empty, check for plugins that break source maps (e.g., @vitejs/plugin-legacy). The analyzer relies on source maps for accurate size calculation.

Vite-based Frameworks

For frameworks built on Vite (VitePress, Remix, Qwik), use analyzerMode: 'server' for accurate results due to multiple build instances.

Static Mode Without Server

When analyzerMode: 'static' and openAnalyzer: false, no development server is created.

API Integration

import { SSE, createServer, injectHTMLTag, openBrowser, renderView } from 'vite-bundle-analyzer'

// Create custom server
const server = createServer()
server.get('/', async (c) => {
  const html = await renderView(data, { title: 'Custom Analyzer', mode: 'parsed' })
  c.res.writeHead(200, { 'Content-Type': 'text/html' })
  c.res.write(html)
  c.res.end()
})
server.listen(3000)

Debug

# Vite
vite build --debug

# Environment variable
ANALYZE_DEBUG=true npm run build

Related

• ROLLDOWN
• CHANGELOG

Contributors

Sponsors

Credits

• Geist UI
• The friend who proposed this idea.
• All contributors and sponsors

License

MIT

0.22.3

• Fix cli can't work.

0.22.2

• Update squarified dependency and add support for Magic Trackpad two fingers action.

0.22.1

• Update dependencies.
• Optimize context menu rendering position.

0.22.0

Break Changes

• Removed the click on a module to scale the viewport. (use context menu instead)

Note

• Upgrade squarified versions
• Improve client to generate module dependency graph
• Added context menu

0.21.0

• Added new enable option to control plugin workflow.
• Add new option include and exclude to filter generated content from the analysis server.

Note

This is one of the final minor releases before the v1.0 launch. We're focusing on polishing core functionality and enhancing stability in preparation for the upcoming major release.

credits

@kricsleo

0.20.2

Prevent server from running in CI environment.

credits

@kricsleo

0.20.1

• Remove unnecessary logic.

0.20.0

• Add rolldown adapter

// rolldown.config.mts
import { analyzer, unstableRolldownAdapter } from 'vite-bundle-analyzer'

unstableRolldownAdapter(analyzer())

0.19.0

• Static resources output.
• The fileName option now supports passing a function to dynamically generate output filenames. This function receives the build metadata and should return a string.
• Support Rolldown. (And Rolldown Vite)

import path from 'path'
analyzer({
  fileName: (outputDir) => path.join(outputDir, 'report.html')
})

0.18.1

• Reduce installer size.

0.18.0

• Use mri to replace commander.js

0.17.3

• Respect Cli parse.

0.17.2

• Fix cli wrong option passing.

0.17.1

• Fixed warning not showing as expected. #58
• Non-js files no need to record child nodes.

credits

@urbnjamesmi1

0.17.0

• Cli add default config path (vite.config.ts)

credits

@kricsleo

0.16.3

• Increase color brightness (Client)
• Improve the smoothness of events (Client)

0.16.2

• Fix Safari render crash.

0.16.1

• Update Client UI.

0.16.0

• Better custom integrate.
• Fix adapter type error.
• Support view brotli size.
• Display no-js file.

0.16.0-beta.4

• Fix adapter type error.

0.16.0-beta.3

Change hook order.

0.16.0-beta.2

• Add Brotli size.
• Display no-js files.

0.16.0-beta.1

Add more friendly API for integrate.

0.15.2

Expose render and other methods to better integrate into custom tools.

0.15.1

• Revert the recent change to avoid bundling crash. (This usually happends when running mulitple instances.)

0.15.0

Improves

• Support vite6.
• Reduce bundle size.
• Improve plugin integration support

0.14.3

Bump client deps.

0.14.2

Patches

• Fix type='module' can't work.

0.14.1

Patches

• Fix error shebang.

0.14.0

Feature & Improves

• Add a simple cli tool. use like:

$ analyze -c ./vite.config.ts

• Adjust treemap background color

0.13.1

Patches

• Fix the fuck vitepress static generator can't work!!!

0.13.0

Major

Replace @carrotsearch/foamtree with squarified. For some reason i think the two library are similar. (And the new one can reduce 200kb) And the new library can better customize the function.

Before v0.13.0 the client look like classic

The new client

now

0.12.1

Better debug log info.

0.12.0

Improves

• Minimum support for vite@3.1.0.

0.11.1

Patches

• Fix #38

0.11.0

Improves & Features

• Add new option defaultSizes. #19
• Static mode support generating living server.(This version will open the client automatically, If you don't want please set openAnalyzer as false.) #37

0.10.6

• Make default options happy.

credits

@a145789

0.10.5

• Reduce debug info package size.
• Makesure tool can be work.

0.10.4

• Add debug info.

0.10.3

Patches

• Fix static report does not work. #29

0.10.2

Patches

• Respect output options.

0.10.1

Patches

• Fix server mode should ensure the safe port.

0.10.0

Improve

• Using @jridgewell/source-map replace source-map. It can reduce 200kb at install stage.
• Perf client rendering logic.

0.9.4

Patches

• Fix the problem of exit of generate task.

credits

@paulcarroll

0.9.3

Improve

• Reduce package size.

Patches

• Fix counting size should skip unknown assets.
• Fix openAnalyzer can't work on WSL/WSL2.

0.9.2

• Reduce package size.

0.9.1

Patches

• Fix use absolute path for working directory. #17

credits

@TSmota

0.9.0

Features

• Add rollup adapter.

import { adapter, analyzer } from 'vite-bundle-analyzer'

plugins: ;
;[adapter(analyzer())]

0.8.3

Patches

• Fix the possible deadlock when generating stats.

0.8.2

Patches

• Fix analyzerPort typo.

0.8.1

Patches

• Using javaScript String index to computing sourcemap.

0.8.0

Improve & Features

• Now file import with query suffix(Like worker and etc) can be collect.
• Module size nearly the actullay size more.
• Remove collect rest module size anymore.

0.7.0

Improve

• Sub module render by chunk size. #14

0.6.1

Patches

• Fix tree-map error deps.

0.6.0

Improve & Features

• Support summary option details see #10.

credits

@a3mitskevich

0.5.0

Imporve & Features

• Remove unnecessary assets or chunk info.
• parsed and gzip size closer to the actual size.
• Modify the data struct for stats.json.
• Full details see #9.

0.4.0

Improve

• Reduce package size.(Three quarters).

0.3.0

Features

• Client Add Search function. #6

credits

@a3mitskevich

0.2.0

Improve & Features

• Client Add Filter by entrypoints.
• Perf client side-bar styles.

Minor

• Changed output target to build.outDir by default.

Credits

@a3mitskevich @nonzzz

0.1.0

Imrpove & Features

This version is a stable version that implements most of the functions of webpack-bundle-analyzer. Provide a more streamlined configuration.

0.0.1

First version.