Tailwind is an installer and runner for tailwind.

Profiles

You can define multiple tailwind profiles. By default, there is a profile called :default which you can configure its args, current directory and environment:

config :tailwind,
  version: "4.3.0",
  default: [
    args: ~w(
      --input=assets/css/app.css
      --output=priv/static/assets/app.css
    ),
    cd: Path.expand("..", __DIR__),
  ]

It is also possible to override the required tailwind CLI version on profile-basis. This is incompatible with the global :path setting, since :path points to a single executable. Configuring a profile with its own :version while :path is set will raise at boot.

Tailwind configuration

There are four global configurations for the tailwind application:

• :version - the expected tailwind version

• :version_check - whether to perform the version check or not. Useful when you manage the tailwind executable with an external tool (eg. npm)

• :path - the path to find the tailwind executable at. By default, it is automatically downloaded and placed inside the _build directory of your current app

• :target - the target architecture for the tailwind executable. For example "linux-x64-musl". By default, it is automatically detected based on system information.

Overriding the :path is not recommended, as we will automatically download and manage tailwind for you. But in case you can't download it (for example, GitHub behind a proxy), you may want to set the :path to a configurable system location.

For instance, you can install tailwind and its CLI tool with npm.

From /assets:

$ npm install tailwindcss @tailwindcss/cli

Then adjust your configuration:

config :tailwind,
  # check if in sync with /assets/package.json
  version: "4.3.0",
  default: [
    args: ~w(
      --input=assets/css/app.css
      --output=priv/static/assets/app.css
    ),
    cd: Path.expand("..", __DIR__),
  ],
  # skip executable check/download
  version_check: false,
  # path to npm managed CLI tool
  path: Path.expand("../assets/node_modules/.bin/tailwindcss", __DIR__)