aligny/tailwind-builder

Composer package to build Tailwind CSS using the standalone CLI binary.

Maintainers

Package info

github.com/ArnaudLigny/tailwind-builder

pkg:composer/aligny/tailwind-builder

Transparency log

Fund package maintenance!

ArnaudLigny

Statistics

Installs: 514

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.2.1 2026-07-01 21:42 UTC

Requires

Requires (Dev)

MIT da6dfb30e651964d8e1e79ccef401b5e09b9dfd8

  • Arnaud Ligny

tailwindtailwindcss

Published on Packagist.org on 2026-07-01 21:43 UTC

This package is auto-updated.

Last update: 2026-07-04 01:39:36 UTC

README

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.