Update Dockerfile, add auto-build workflow, update README

- Rename TAILWIND_VERSION to TAILWINDCSS_VERSION for consistency- Add Watchman to get rid of bugging error - Improve container cleanup and signal handling- Update build arguments in Justfile
- Add GitHub Actions workflow for auto-building Docker images
- Add Justfile for build automation
- Add docker-compose.yml for local development
- Add initial input.css for examples

Author: scriptogre

.github/workflows/auto-release.yml

@@ -0,0 +1,45 @@
+name: Auto Build TailwindCSS Image
+
+on:
+  schedule:
+    - cron: '0 0 * * *'  # daily at 00:00 UTC
+  workflow_dispatch:     # manual trigger via `Actions` tab
+
+jobs:
+  build-and-push-image:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      packages: write
+      attestations: write
+      id-token: write
+
+    steps:
+      - name: Checkout repository (containing the Dockerfile)
+        uses: actions/checkout@v4
+
+      - name: Authenticate with GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - id: get-latest-release
+        name: Fetch latest TailwindCSS release
+        uses: pozetroninc/github-action-get-latest-release@v0.8.0
+        with:
+          repository: tailwindlabs/tailwindcss
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v4
+        with:
+          context: .
+          file: Dockerfile
+          push: true
+          tags: |
+            ghcr.io/scriptogre/tailwindcss:latest
+            ghcr.io/scriptogre/tailwindcss:${{ steps.get-latest-release.outputs.release }}
+          build-args: |
+            TAILWINDCSS_VERSION=${{ steps.get-latest-release.outputs.release }}

Dockerfile

@@ -1,43 +1,50 @@
-# ─── Stage 1: Download Tailwind CLI ─────────────────────────
+# ─── Stage 1: Download TailwindCSS CLI ─────────────────────────
 FROM curlimages/curl:latest AS downloader
 
-ARG TAILWIND_VERSION=4.1.5
+ARG TAILWINDCSS_VERSION
 ARG TARGETPLATFORM
 ARG TARGETVARIANT
 
-# Download TailwindCSS standalone CLI
+# Download TailwindCSS CLI
 RUN set -eux; \
     platform="$TARGETPLATFORM"; \
     OS="${platform%/*}"; \
     ARCH="${platform#*/}"; \
     [ "$ARCH" = "amd64" ] && ARCH=x64; \
     [ "$ARCH" = "aarch64" ] && ARCH=arm64; \
-    url="https://github.com/tailwindlabs/tailwindcss/releases/download/v${TAILWIND_VERSION}/tailwindcss-${OS}-${ARCH}${TARGETVARIANT}"; \
+    url="https://github.com/tailwindlabs/tailwindcss/releases/download/v${TAILWINDCSS_VERSION}/tailwindcss-${OS}-${ARCH}${TARGETVARIANT}"; \
     curl -fSL -o /tmp/tailwindcss "$url"; \
     chmod +x /tmp/tailwindcss
 
 
 # ─── Stage 2: Final Image ───────────────────────────────────────────────
 FROM debian:bullseye-slim
 
-ARG TAILWIND_VERSION=4.1.5
+ARG TAILWINDCSS_VERSION
 
 # Image metadata
 LABEL org.opencontainers.image.title="Tailwind CSS CLI Docker Image"
 LABEL org.opencontainers.image.description="Minimal Docker image packaging the Tailwind CSS standalone CLI"
 LABEL org.opencontainers.image.documentation="https://github.com/scriptogre/tailwindcss-docker#readme"
 LABEL org.opencontainers.image.source="https://github.com/scriptogre/tailwindcss-docker"
 LABEL org.opencontainers.image.url="https://github.com/scriptogre/tailwindcss"
-LABEL org.opencontainers.image.version="${TAILWIND_VERSION}"
+LABEL org.opencontainers.image.version="${TAILWINDCSS_VERSION}"
 LABEL org.opencontainers.image.authors="scriptogre"
 
-# Copy Tailwind CLI from `downloader` stage
+# Install Watchman
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends watchman && \
+    rm -rf /var/lib/apt/lists/*
+
+# Copy Tailwind CLI from `downloader`
 COPY --from=downloader /tmp/tailwindcss    /usr/local/bin/tailwindcss
 
-# Set /code as work dir (this is where user's files should be mounted)
-WORKDIR /code
+WORKDIR /app
 
 ENTRYPOINT ["/usr/local/bin/tailwindcss"]
 
+# Ensures container doesn't hang on CTRL+C (alternative is setting `stop_grace_period: 0` in `docker-compose.yml`)
+STOPSIGNAL SIGKILL
+
 # Default to TailwindCSS CLI's help message
 CMD ["--help"]

Justfile

@@ -0,0 +1,10 @@
+rebuild release_version:
+    docker build \
+        --build-arg TAILWINDCSS_VERSION={{release_version}} \
+        -t ghcr.io/scriptogre/tailwindcss:{{release_version}} \
+        -t ghcr.io/scriptogre/tailwindcss:latest \
+        .
+
+push release_version:
+    docker push ghcr.io/scriptogre/tailwindcss:{{release_version}}
+    docker push ghcr.io/scriptogre/tailwindcss:latest

README.md

@@ -1,40 +1,33 @@
-# TailwindCSS Docker Image
-
-A minimal Docker image for the Tailwind CSS standalone CLI that bundles `tini` for proper signal forwarding.
-
-## Usage Example
-
-Pull and run the image:
-
+# TailwindCSS Docker
+
+A dead simple way to run [Tailwind CSS](https://tailwindcss.com/) from a Docker container. 
+
+No more **Node.JS**. No more **manual downloads of the CLI**.
+
+1. Create `input.css` in your project:
+    ```css
+    @import 'tailwindcss';
+    ``` 
+2. Create `docker-compose.yml` in your project:
+    ```yaml
+    services:
+      tailwindcss:
+        # You can also use pinned versions, e.g. `:4.1.7`
+        image: ghcr.io/scriptogre/tailwindcss:latest
+        volumes:
+          - .:/app
+        command: -i ./input.css -o ./output.css --watch
+    ```
+
+3.  Or run `docker run` command:
 ```bash
-docker run \
-  --init \
-  --rm \
-  --volume "$(pwd)":/code \
-  ghcr.io/scriptogre/tailwindcss:latest \
-    -i ./static/css/input.css \
-    -o ./static/css/output.css \
-    --watch=always
-```
-
-Or with Docker Compose:
-
-```yaml
-services:
-   tailwindcss:
-      image: ghcr.io/scriptogre/tailwindcss:latest
-      volumes:
-         - .:/code
-      command: [
-         "-i", "./static/css/input.css",
-         "-o", "./static/css/output.css",
-         "--watch=always"
-      ]
-      init: true
+docker run \ 
+  -v "$(pwd)":/app \
+  ghcr.io/scriptogre/tailwindcss:latest \ 
+  -i ./input.css -o ./output.css --watch
 ```
 
-## Notes
 
-- The final image is based on `debian:bullseye-slim` and includes the `tailwindcss` CLI.
-- The container expects a bind mount from the host to `/code`, where your Tailwind CSS files are located.
-- Use `init: true` in docker-compose for proper signal handling.
+### **Notes:**
+- Make sure you mount all source files (`*.html`, `*.css`, `*.js`, …) to `/app`, so Tailwind’s watcher can see them within the container.
+- The `ghcr.io/scriptogre/tailwindcss:latest` image is rebuilt daily to track the newest Tailwind CSS release.

docker-compose.yml

@@ -0,0 +1,7 @@
+services:
+  tailwindcss:
+    image: ghcr.io/scriptogre/tailwindcss:latest
+    tty: true
+    volumes:
+      - .:/app
+    command: ["-i", "./input.css", "-o", "./output.css", "--watch"]