# Tailwind v4 ohne Node

Jede Seite kompiliert nur die Klassen, die sie verwendet, in PHP.

## Eine Einstellung, kein Build-Schritt

Lege `tailwind.enabled` in `blockstudio.json` fest und schreibe Utility-Klassen in beliebige Templates. Bei jeder Frontend-Anfrage sammelt Blockstudio die Klassenkandidaten im fertigen HTML und kompiliert mit TailwindPHP genau diese – einer PHP-Portierung von Tailwind CSS 4.3.

Es gibt weder Node.js noch CLI noch einen Watcher. Klassen aus Block-Templates, Theme-Templates, Plugins und `the_content` zählen alle, weil die gesamte Seite durchsucht wird.

[Tailwind aktivieren](https://blockstudio.dev/de/docs/tailwind/#enabling-tailwind)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true
  }
}
```

## Keine Node-Laufzeit

TailwindPHP kompiliert während der Anfrage; es gibt nichts zu bauen oder bereitzustellen.

## Tailwind-4.3-Utilities

Utilities, Varianten, beliebige Werte und Direktiven aus Tailwind CSS 4.3.

## Seitenweite Suche

Klassen zählen überall dort, wo sie im fertigen HTML vorkommen.

## Nach Klassensatz gecacht

Seiten mit denselben Klassen teilen sich eine kompilierte Datei.

## CSS-First-Konfiguration

@theme-Tokens und @utility-Regeln in blockstudio.json oder einem Filter.

## Live-Vorschau im Editor

Eine gebündelte Browserversion zeigt Klassen während der Eingabe in der Vorschau.

## Verknüpfte Ausgabe

Ein inhaltsgehashtes Stylesheet, das Browser und Edge-Caches vorhalten können.

## Typography und Forms

Die beiden offiziellen Plugins wurden auf PHP portiert und werden mit @plugin geladen.

## Konfiguriert in CSS

Tailwind v4 wird mit CSS konfiguriert, nicht mit einer JavaScript-Datei. Füge `@theme`-Tokens, `@utility`-Regeln und Ebenen in `tailwind.config` ein oder ergänze sie über den `blockstudio/tailwind/css`-Filter, wenn sie sich über mehrere Zeilen erstrecken.

Die offiziellen Typography- und Forms-Plugins wurden auf PHP portiert und werden mit `@plugin` geladen. Plugins, die nur als JavaScript-Pakete verfügbar sind, laufen nicht, da nichts Node ausführt.

Klassen-Aliase sind `@apply`-Regeln innerhalb von `@layer utilities`, zum Beispiel ein `.btn` aus Padding- und Radius-Utilities. Sie werden sowohl im Frontend als auch in der Editor-Vorschau kompiliert.

[Konfiguration](https://blockstudio.dev/de/docs/tailwind/#configuration)

functions.php

```
add_filter('blockstudio/tailwind/css', function (string $css): string {
  return $css . '
    @plugin "@tailwindcss/typography";
    @theme { --color-brand: #4f46e5; }
    @utility container-narrow {
      max-width: 48rem;
      margin-inline: auto;
    }
  ';
});
```

## Klassen als Feld

Gib einem `classes`-Feld `"tailwind": true`, und Redakteure erhalten Autovervollständigung aus der vollständigen Klassenliste. Eine gebündelte Tailwind-Browserversion zeigt jede Änderung auf der Leinwand in der Vorschau.

Mit `assets.reset.enabled` stellt die Leinwand außerdem Anzeige- und Positions-Utilities wie `flex`, `grid` und `sticky` wieder her, die sonst von den Editor-Wrapper-Regeln überschrieben würden.

[Feldtyp für Klassen](https://blockstudio.dev/de/docs/tailwind/#classes-field-type)

block.json

```
{
  "name": "acme/hero",
  "title": "Hero",
  "blockstudio": {
    "attributes": [
      {
        "id": "classes",
        "type": "classes",
        "label": "Classes",
        "tailwind": true,
        "default": "bg-white text-gray-900"
      }
    ]
  }
}
```

## Ein Stylesheet, nach Klassensatz gecacht

Kompiliertes CSS wird auf dem Datenträger unter einem Schlüssel gecacht, der aus den sortierten Klassenkandidaten der Seite und der Eingabe CSS gebildet wird. So machen Nonces und Zeitstempel den Cache nie ungültig, und Seiten mit denselben Klassen teilen sich eine Datei.

Die Inline-Ausgabe ist der Standard. `"output": "link"` gibt stattdessen diese Cache-Datei als inhaltsgehashtes Stylesheet aus. Bei einer Messung an einer lokalen Kopie dieser Website am 8. Oktober 2026 sank die Größe der Startseite dadurch von HTML 451,648 auf 296,379 Bytes.

Wenn `cache.path` auf ein privates Volume verweist, wechselt Blockstudio zu Inline-CSS, sofern der `blockstudio/files/url`-Filter nicht ein öffentliches URL für den Geltungsbereich `tailwind` zurückgibt, etwa einen CDN-Host.

[Frontend-Ausgabe](https://blockstudio.dev/de/docs/tailwind/#frontend-output)

blockstudio.json

```
{
  "tailwind": {
    "enabled": true,
    "output": "link"
  }
}
```

## Klassen in PHP zusammenführen

`bs_tw_merge()` löst widersprüchliche Utilities auf, sodass eine selbst definierte Klasse Vorrang vor einem Standardwert hat. `bs_tw_variants()` gibt eine Variant-Funktion mit Basisklassen, Varianten, Standardwerten und kombinierten Varianten zurück.

Beide verwenden die Engine TailwindPHP, die Blockstudio bereits bündelt. Daher braucht ein Theme keine eigene Kopie.

[Template-Helfer](https://blockstudio.dev/de/docs/tailwind/#template-composition-helpers)

index.php

```
echo bs_tw_merge('px-2 text-sm', 'px-4');
// text-sm px-4

$button = bs_tw_variants([
  'base' => 'inline-flex items-center',
  'variants' => [
    'size' => ['sm' => 'h-8 px-3', 'lg' => 'h-12 px-6'],
  ],
  'defaultVariants' => ['size' => 'sm'],
]);

echo $button(['size' => 'lg', 'class' => 'rounded']);
```

## Bei Bedarf leeren

Runtime_Cache::purge(‘tailwind’) löscht das kompilierte CSS; bei der nächsten Anfrage wird es erneut kompiliert.

## Optionaler Seitenpuffer

Eine Website, die weder Tailwind noch Block-Assets verwendet, kann den Seitenpuffer mit dem Filter blockstudio/buffer/enabled deaktivieren.

## Pro Quelle isoliert

Bei einer logischen Erkennungsquelle werden die ausgewählte Quelle und der Laufzeitkontext Teil des Cache-Namespace, sodass zuletzt erfolgreiche CSS-Ergebnisse nicht zwischen Vorschauen durchsickern.

## Kanonische Ebenenreihenfolge

Theme, Basis, Komponenten, dann Utilities wie in Tailwind CSS, sodass spätere Ebenen frühere überschreiben.

Plus

## Das offizielle Erweiterungspaket

Premium-Websitevorlagen, KI-Systemanweisungen und eine private Discord-Community. Einmaliger Kauf, Updates auf Lebenszeit.

- 500+ Website-Vorlagen
- KI-Systemanweisungen
- Updates auf Lebenszeit
- Private Discord-Community

[Plus holen](https://blockstudio.dev/de/plus/)
