BunBundle installs and runs Bun as an asset bundler for Elixir web apps.

It vendors a small JS bundler taken from its counterpart, the Ruby gem bun_bun_bundle, and runs it under Bun. Bun ships Lightning CSS built in. That covers glob imports, nesting, autoprefixing, and minification without a separate CSS toolchain.

Configuration

config :bun_bundle, version: "1.4.2"

All bundler configuration lives in config/bun.json at your project root. Bun reads it directly. BunBundle does not translate config. The same format is used by the Ruby and Crystal ports.

Global options

• :version. The expected Bun version.
• :version_check. Whether to warn on version drift at boot. Defaults to true.
• :path. Override the path to the Bun binary. By default it is downloaded to _build/bun-<target>.

Usage in Phoenix

# config/dev.exs
config :my_app, MyAppWeb.Endpoint,
  watchers: [
    bun: {BunBundle, :install_and_run, [~w(--dev)]}
  ]

# mix.exs aliases
"assets.setup": ["bun.install --if-missing"],
"assets.build": ["bun"],
"assets.deploy": ["bun --prod", "phx.digest"]