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.0.9",
  default: [
    args: ~w(
      --input=css/app.css
      --output=../priv/static/assets/app.css
    ),
    cd: Path.expand("../assets", __DIR__),
  ]

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 globally with npm:

$ npm install -g tailwindcss

On Unix, the executable will be at:

NPM_ROOT/tailwind/node_modules/tailwind-TARGET/bin/tailwind

On Windows, it will be at:

NPM_ROOT/tailwind/node_modules/tailwind-windows-(32|64)/tailwind.exe

Where NPM_ROOT is the result of npm root -g and TARGET is your system target architecture.

Once you find the location of the executable, you can store it in a MIX_TAILWIND_PATH environment variable, which you can then read in your configuration file:

config :tailwind, path: System.get_env("MIX_TAILWIND_PATH")