🎉 Initial release

astro-bundle-budget is an Astro integration that audits your JS and CSS bundle sizes at build time — and optionally fails the build when you exceed your thresholds.

Features

• Per-file budgets — set size limits on individual assets using glob patterns
• Per-page budgets — limit the total JS/CSS payload a single page may reference
• Compression-aware — measure gzip or brotli wire sizes instead of raw bytes
• Dev Toolbar panel — live bundle stats visible inside astro dev
• JSON report — write bundle-budget-report.json to outDir for CI artefact diffing
• Zero runtime dependencies — Node built-ins only

Install

npm install -D astro-bundle-budget

Usage

// astro.config.mjs
import bundleBudget from 'astro-bundle-budget'

export default defineConfig({
  integrations: [
    bundleBudget({
      budgets: [
        { path: 'assets/vendor-*.js', budget: '50 kB' },
        { path: '**/*.js',            budget: '100 kB' },
        { path: '**/*.css',           budget: '20 kB' },
      ],
    })
  ]
})

Links

• npm
• Documentation