{"id":21249,"library":"esbuild-plugin-filesize","title":"esbuild-plugin-filesize","description":"An ESBuild plugin that displays filesize information for output bundles after build. Current stable version is 0.4.0. The plugin integrates seamlessly with ESBuild and shows file sizes in kilobytes with color-coded output. It is part of the LinbuduLab nx-plugins ecosystem. Unlike other filesize plugins, this one is specifically tailored for ESBuild's plugin API and provides immediate visual feedback in the console. Releases follow semantic versioning but the package is maintained as part of a monorepo with occasional updates.","status":"active","version":"0.4.0","language":"javascript","source_language":"en","source_url":"https://github.com/LinbuduLab/esbuild-plugins","tags":["javascript","esbuild","ESBuild","filesize","plugin","typescript"],"install":[{"cmd":"npm install esbuild-plugin-filesize","lang":"bash","label":"npm"},{"cmd":"yarn add esbuild-plugin-filesize","lang":"bash","label":"yarn"},{"cmd":"pnpm add esbuild-plugin-filesize","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required for ESBuild plugin API.","package":"esbuild","optional":false}],"imports":[{"note":"Package is ESM-only. CommonJS require will fail.","wrong":"const filesizePlugin = require('esbuild-plugin-filesize')","symbol":"default","correct":"import filesizePlugin from 'esbuild-plugin-filesize'"},{"note":"Default export, not named. Do not destructure.","wrong":"const { filesizePlugin } = require('esbuild-plugin-filesize')","symbol":"filesizePlugin","correct":"import filesizePlugin from 'esbuild-plugin-filesize'"},{"note":"TypeScript type import only. Not a runtime value.","wrong":"import { FilesizePluginOptions } from 'esbuild-plugin-filesize'","symbol":"FilesizePluginOptions (type)","correct":"import type { FilesizePluginOptions } from 'esbuild-plugin-filesize'"}],"quickstart":{"code":"import esbuild from 'esbuild';\nimport filesizePlugin from 'esbuild-plugin-filesize';\n\nawait esbuild.build({\n  entryPoints: ['app.js'],\n  bundle: true,\n  outfile: 'out.js',\n  plugins: [filesizePlugin()],\n  // Optional: filesizePlugin({ showGzipped: true })\n});","lang":"typescript","description":"Basic setup of esbuild-plugin-filesize in an ESBuild build script with default options."},"warnings":[{"fix":"Use filesizePlugin() with parentheses.","message":"Plugin must be called as a function even with no options: filesizePlugin() not filesizePlugin.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Set showGzipped: false to revert to old behavior.","message":"Version 0.3.0 changed default from showing only uncompressed size to showing both uncompressed and gzipped sizes.","severity":"breaking","affected_versions":">=0.3.0"},{"fix":"Ensure 'write' is true or use a different method to get file sizes.","message":"The plugin does not support ESBuild's 'write: false' mode because it reads files after writing.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Run npm install esbuild-plugin-filesize --save-dev","cause":"Package not installed or not in node_modules.","error":"Error: Cannot find module 'esbuild-plugin-filesize'"},{"fix":"Use: import filesizePlugin from 'esbuild-plugin-filesize'","cause":"Imported as named export instead of default export.","error":"TypeError: filesizePlugin is not a function"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}