Anleitung

Ein Bootstrap-Grid zu Tailwind CSS migrieren

Ein Layout vom Grid von Bootstrap zu Tailwind umzuziehen dauert fünf Schritte und größtenteils nur einen Befehl. Diese Anleitung zeigt, was sich ändert, wie die Klassen zugeordnet werden und die wenigen Dinge, die ein Skript nicht für dich erledigen kann.

Migration in fünf Schritten

  1. Plugin installieren

    Installiere tw-bootstrap-grid und registriere es in deinem Tailwind-Setup. Die Installationsanleitung enthält die Snippets für Tailwind v3 und v4.

  2. Breakpoints von Bootstrap nachbilden (optional)

    Wenn Layouts bei denselben Breiten wie zuvor umschalten sollen, setze die Screens von Tailwind auf 576, 768, 992, 1200 und 1400px. Siehe die Breakpoints weiter unten.

  3. Klassen umbenennen

    Committe deine Arbeit und führe dann den Perl-Befehl unten aus. Er nummeriert die Gutter neu und macht aus col-md-6 von Bootstrap md:col-6.

  4. Beheben, was der Befehl nicht kann

    Ändere Abstands-Utilities wie mb-3 in mb-4, tausche die Display- und Flex-Utilities von Bootstrap gegen die von Tailwind und ersetze Klassen wie container-md.

  5. Bootstrap-CSS entfernen und Ergebnis prüfen

    Nimm das Bootstrap-Stylesheet heraus und sieh dir deine Seiten dann bei Smartphone-, Tablet- und Desktop-Breite an.

Was sich ändert und was nicht

  • Was gleich bleibt

    Die Struktur: .container, .row, .col-*, .offset-*, .row-cols-*. Sogar die CSS-Variablen behalten ihre Namen, --bs-gutter-x und --bs-gutter-y, eigenes CSS, das sie liest, funktioniert also weiter.

  • Präfix statt Infix

    Bootstrap schreibt col-md-6. Tailwind schreibt md:col-6. Das ist die Änderung, die du am häufigsten anfassen wirst, und ein Skript kann sie für dich erledigen.

  • Andere Zahlen

    Gutter- und Abstandszahlen folgen der Skala von Tailwind, das g-3 von Bootstrap ist hier also g-4. Auch die Breakpoint-Breiten weichen etwas ab.

Dasselbe Layout, vorher und nachher

Bootstrap 5

index.html
<div class="container">
  <div class="row g-3">
    <div class="col-12 col-md-6 col-lg-4">A</div>
    <div class="col-12 col-md-6 col-lg-4">B</div>
    <div class="col-12 col-md-12 col-lg-4">C</div>
  </div>
</div>

tw-bootstrap-grid

index.html
<div class="container">
  <div class="row g-4">
    <div class="col-12 md:col-6 lg:col-4">A</div>
    <div class="col-12 md:col-6 lg:col-4">B</div>
    <div class="col-12 md:col-12 lg:col-4">C</div>
  </div>
</div>

Klassenzuordnung

Responsive Klassen

Responsive Klassen
BootstrapHierHinweise
col-md-6md:col-6Tailwind setzt den Breakpoint voran, als Präfix.
col-lglg:colDasselbe gilt für die gleich breite Spalte.
col-xl-autoxl:col-auto
offset-md-3md:offset-3
row-cols-md-3md:row-cols-3
g-md-4md:g-6Auch die Zahl ändert sich, siehe die Gutter-Größen weiter unten.
col-xxl-42xl:col-4Das xxl von Bootstrap heißt in Tailwind 2xl.
order-md-2md:order-2order-* kommt von Tailwind und geht bis 12.

Gutter-Größen

Gutter-Größen
BootstrapHierGröße
g-0g-00
g-1g-10.25rem
g-2g-20.5rem
g-3g-41rem
g-4g-61.5rem
g-5g-123rem

Utilities, die von Tailwind kommen

Utilities, die von Tailwind kommen
BootstrapHierHinweise
d-flexflex
d-none d-md-blockhidden md:block
justify-content-betweenjustify-between
align-items-centeritems-center
align-self-endself-end
mb-3, p-3mb-4, p-4Abstands-Utilities verschieben sich genauso wie die Gutter.

Breakpoints von Bootstrap nachbilden

Die Breakpoints von Bootstrap sind 576, 768, 992, 1200 und 1400px. Die von Tailwind sind 640, 768, 1024, 1280 und 1536px, ein Layout kann nach der Migration also etwas früher oder später umschalten. Wenn das wichtig ist, setze die Screens von Tailwind auf die Werte von Bootstrap.

Tailwind v4

main.css
@import "tailwindcss";
@plugin "tw-bootstrap-grid";

@theme {
  --breakpoint-sm: 36rem;    /* 576px */
  --breakpoint-md: 48rem;    /* 768px */
  --breakpoint-lg: 62rem;    /* 992px */
  --breakpoint-xl: 75rem;    /* 1200px */
  --breakpoint-2xl: 87.5rem; /* 1400px */
}

Der container von Tailwind ist so breit wie der Breakpoint, auf dem er sitzt, seine Maximalbreiten werden also 576, 768, 992, 1200 und 1400px. Das ist nah an den 540, 720, 960, 1140 und 1320px von Bootstrap, aber nicht identisch.

Massenweise umbenennen

Dieser Perl-Befehl nummeriert die Gutter neu und macht aus col-md-6 md:col-6, aus col-xxl-4 2xl:col-4 und aus dem alten no-gutters g-0. Er schreibt die Dateien direkt um, committe also zuerst und lies danach den Diff.

terminal
perl -pi -e '
  s/\b(g|gx|gy)-((?:sm|md|lg|xl|xxl)-)?([345])\b/"$1-".($2\/\/"").{3=>4,4=>6,5=>12}->{$3}/ge;
  s/\bno-gutters\b/g-0/g;
  s/\b(col|offset|order|row-cols|g|gx|gy)-(sm|md|lg|xl|xxl)(-([0-9]+|auto|first|last))?\b/$2:$1$3/g;
  s/\bxxl:/2xl:/g;
' $(git ls-files '*.html' '*.jsx' '*.tsx' '*.vue' '*.svelte')

Einmal ausführen und das Ergebnis prüfen

Ein zweiter Durchlauf würde die Gutter erneut neu nummerieren. Außerdem kennt er nur die Klassennamen oben, Abstands-Utilities wie mb-3 oder p-3 brauchen also eine manuelle Runde, und das Muster trifft jeden Text, der wie eine Klasse aussieht, auch in Kommentaren.

Was nicht übernommen wird

Das Plugin fügt nur .container und .container-fluid hinzu, .container-sm, .container-md und die anderen responsiven Container von Bootstrap sind also nicht enthalten. Baue sie bei Bedarf mit den max-w-*-Utilities von Tailwind. Die übrigen Utilities von Bootstrap (Display, Flex, Abstand, Text) werden durch die von Tailwind ersetzt, wie in der letzten Tabelle oben.

Weiter geht's