PHPackages                             aligny/tailwind-builder - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. aligny/tailwind-builder

ActiveLibrary[Utility & Helpers](/categories/utility)

aligny/tailwind-builder
=======================

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

1.1.0(1w ago)0123↓40.4%MITPHPPHP ^8.1CI passing

Since May 18Pushed 1w agoCompare

[ Source](https://github.com/ArnaudLigny/tailwind-builder)[ Packagist](https://packagist.org/packages/aligny/tailwind-builder)[ GitHub Sponsors](https://github.com/ArnaudLigny)[ RSS](/packages/aligny-tailwind-builder/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (3)Versions (6)Used By (0)

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

Installation
------------

[](#installation)

```
composer require aligny/tailwind-builder
```

Usage
-----

[](#usage)

```
vendor/bin/tailwind-builder
```

Example with options:

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

### Install globally

[](#install-globally)

To install the command globally, you can use:

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

Backward compatibility:

- `vendor/bin/tailwind-build` remains available as an alias to `vendor/bin/tailwind-builder`.

Options
-------

[](#options)

- `input` (argument): source CSS path. Default: `assets/tailwind.css`
- `--output|-o`: compiled CSS path. Default: `/styles.css`
- `--watch|-w`: watch mode
- `--minify|-m`: minification
- `--config|-c`: Tailwind config path (mainly for v3)
- `--tailwind-version`: Tailwind version (default `v4.3.0`)
- `--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)

Notes
-----

[](#notes)

- The binary is downloaded from Tailwind GitHub Releases and cached in `.cache/tailwind//`.
- 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.

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance98

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

5

Last Release

13d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/52a734f97ce4ef72fb07b59e5d0f7f6a26a0b322da49b881bedc3896c5e7f128?d=identicon)[aligny](/maintainers/aligny)

---

Top Contributors

[![ArnaudLigny](https://avatars.githubusercontent.com/u/80580?v=4)](https://github.com/ArnaudLigny "ArnaudLigny (17 commits)")

---

Tags

tailwindtailwindcsstailwindtailwindcss

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/aligny-tailwind-builder/health.svg)

```
[![Health](https://phpackages.com/badges/aligny-tailwind-builder/health.svg)](https://phpackages.com/packages/aligny-tailwind-builder)
```

###  Alternatives

[matomo/matomo

Matomo is the leading Free/Libre open analytics platform

21.6k38.2k](/packages/matomo-matomo)[spatie/laravel-export

Create a static site bundle from a Laravel app

670139.5k6](/packages/spatie-laravel-export)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)