Esbuild

Mix tasks for installing and invoking esbuild.

Installation

If you are going to build assets in production, then you add esbuild as dependency on all environments but only start it in dev:

def deps do
  [
    {:esbuild, "~> 0.1", runtime: Mix.env() == :dev}
  ]
end

However, if your assets are precompiled during development, then it only needs to be a dev dependency:

def deps do
  [
    {:esbuild, "~> 0.1", only: :dev}
  ]
end

Once installed, change your config/config.exs to pick your esbuild version of choice:

config :esbuild, version: "0.12.15"

Now you can install esbuild by running:

$ mix esbuild.install

And invoke esbuild with:

$ mix esbuild default assets/js/app.js --bundle --minify --target=es2016 --outdir=priv/static/assets/

The executable is kept at _build/esbuild.

Contexts

The first argument to esbuild is the execution context. You can define multiple execution contexts with the current directory, the OS enviroment, and default arguents to the esbuild task:

config :esbuild,
  version: "0.12.15",
  default: [
    args: ~w(js/app.js --bundle --target=es2016 --outdir=../priv/static/assets),
    cd: Path.expand("../assets", __DIR__),
    env: %{"NODE_PATH" => Path.expand("../deps", __DIR__)}
  ]

When mix esbuild default is invoked, the task arguments will be appended to the ones configured above.

License

esbuild source code is licensed under the MIT License.