A Composer package that compiles CSS using the Tailwind standalone binary matching the current OS.

Installation

composer require aligny/tailwind-builder

Usage

vendor/bin/tailwind-builder assets/tailwind.css

Example with options:

vendor/bin/tailwind-builder tailwind.css \
  --output=public/styles.css \
  --minify \
  --tailwind-version=v4.3.0

Options

• input (argument): source CSS path. Default: assets/tailwind.css
• --output|-o: compiled CSS path. Default: <input-path>/styles.css
• --watch|-w: watch mode
• --minify|-m: minification
• --config|-c: Tailwind config path (mainly for v3)
• --tailwind-version: Tailwind version (default latest, resolved from Tailwind GitHub Releases API)
• --platform: platform override (auto, linux-x64, linux-arm64, macos-x64, macos-arm64, windows-x64, etc.)
• --bin-path: explicit path to a local binary (skips download)
• --checksum: expected binary SHA-256 (hex or sha256: prefix)
• --insecure-skip-checksum-verification: disables checksum verification (not recommended)

Install globally

To install the command globally, you can use:

composer global require aligny/tailwind-builder
composer global config bin-dir --absolute

GitHub Action

You can use this repository as a composite action from another workflow:

- name: Build Tailwind CSS
  uses: ArnaudLigny/tailwind-builder@main
  with:
    working-directory: .
    input: assets/tailwind.css
    output: public/styles.css
    minify: true
    tailwind-version: latest

Notes

• The binary is downloaded from Tailwind GitHub Releases and cached in .cache/tailwind/<version>/.
• By default, the package verifies the binary SHA-256 using the digest exposed by the GitHub Releases API; if metadata is unavailable, the command fails to avoid running an unverified binary.
• You can explicitly provide a hash with --checksum (useful in restricted/offline environments).
• During concurrent execution, a lock file prevents simultaneous downloads.