Kurs vibe coding z Claude Code · Moduł 2: Projekt Next.js z Claude Code

Tailwind CSS: czytaj klasy, które pisze Claude

8 min czytania ·
W tej lekcji9

Projekt stoi ale strona wciąż wygląda jak szablon Next.js. Czas na pierwszą sekcję Kraken's Call. Napisze ją Claude Code, w Tailwind CSS, a Ty nauczysz się czytać to, co napisał.

Problem: przycisk z dziewięcioma klasami

Claude odda Ci przycisk z długim ciągiem klas. Jeśli ich nie przeczytasz, nie wiesz, czy przycisk jest czytelny na telefonie, czy tekst odcina się od tła i czy agent nie użył składni sprzed dwóch lat. Nie musisz pamiętać setek klas: wystarczy, że rozpoznasz kilka rodzin, a resztę sprawdzisz w ściądze poniżej albo na tailwindcss.com.

Tailwind w jednym akapicie

Tailwind CSS to framework CSS typu utility-first: zamiast pisać własne reguły CSS, składasz wygląd z małych gotowych klas, z których każda robi jedną rzecz. Kreator z poprzedniej lekcji zainstalował go od razu. Tak wygląda czerwony przycisk w zwykłym CSS:

.button {
  background-color: #dc2626;
  color: white;
  padding: 12px 24px;
  border-radius: 8px;
}

Reguła siedzi w osobnym pliku CSS, a w HTML zostaje tylko nazwa button, więc żeby wiedzieć, jak przycisk wygląda, otwierasz dwa pliki. Podobny przycisk w Tailwindzie mieści się w jednej linii:

<button class="bg-red-600 text-white px-6 py-3 rounded-lg">Dołącz do załogi!</button>

Każda klasa to jeden żagiel: bg-red-600 daje czerwone tło, text-white biały tekst, px-6 i py-3 odstępy wewnątrz, a rounded-lg zaokrąglone rogi. W zwykłym HTML atrybut nazywa się class, a w plikach .tsx projektu Next.js className, bo class jest w JavaScripcie słowem zarezerwowanym. Same klasy są identyczne.

Polecenie dla Claude Code

Uruchom serwer z poprzedniej lekcji (npm run dev w drugim terminalu) i wydaj w sesji w folderze krakens-call takie polecenie:

Polecenie dla Claude Code:

Zastąp zawartość @app/page.tsx sekcją hero dla Kraken's Call: czarne tło
na całą wysokość ekranu, treść wyśrodkowana w pionie i w poziomie,
czerwony nagłówek "Kraken's Call", jedno zdanie opisu gry i złoty
przycisk "Dołącz do załogi", ciemniejszy po najechaniu. Tylko klasy
Tailwind, bez nowych plików CSS i bez nowych paczek. Na koniec uruchom
npm run build i npm run lint i pokaż wynik.

Polecenie opisuje wygląd słowami, a nie klasami: klasy dobiera Claude, a Ty je sprawdzasz. Ograniczenie "tylko klasy Tailwind" pilnuje, żeby nie powstał osobny plik CSS, a dwa sprawdziany na końcu dają dowód, że kod się buduje i przechodzi lintera.

Co napisał Claude

Otwórz w Cursorze app/page.tsx i czytaj od góry, kawałek po kawałku. Najpierw kontener, czyli element <main>, który obejmuje całą sekcję:

<main className="flex min-h-screen items-center justify-center bg-black px-6">

flex włącza flexbox, czyli układ, w którym dzieci elementu ustawiają się w rzędzie. items-center wyśrodkowuje je w pionie, a justify-center w poziomie. min-h-screen daje wysokość co najmniej całego ekranu, bez niej wyśrodkowania w pionie nie byłoby widać. bg-black to czarne tło, a px-6 zostawia odstęp od krawędzi telefonu. Żadna z tych klas nie zmienia koloru tekstu: to robią klasy na nagłówku i opisie.

Wewnątrz jest <div> z klasami max-w-xl text-center, który ogranicza szerokość treści i wyśrodkowuje tekst. W nim nagłówek i opis:

<h1 className="text-4xl font-bold text-red-600 md:text-6xl">
  Kraken&apos;s Call
</h1>
<p className="mt-4 text-lg text-gray-300">
  Piracka gra w przeglądarce: zbierz załogę i stań do walki z krakenem.
</p>

text-4xl to rozmiar tytułu, a md:text-6xl powiększa go na szerszych ekranach, o czym za chwilę. font-bold pogrubia, text-red-600 barwi na czerwono, mt-4 dodaje 16 pikseli odstępu nad opisem, a text-gray-300 daje jasnoszary tekst na czarnym tle. &apos; to zapisany w JSX apostrof: wygląda na stronie jak zwykły znak ', ale linter go nie zgłosi.

Na końcu przycisk, najdłuższy ciąg w pliku:

<button className="mt-8 rounded-lg bg-yellow-500 px-6 py-3 font-semibold text-black transition-colors hover:bg-yellow-600">
  Dołącz do załogi
</button>

mt-8 odsuwa przycisk o 32 piksele od opisu, px-6 i py-3 dają 24 piksele odstępu po bokach i 12 u góry i dołu, rounded-lg zaokrągla rogi, font-semibold pogrubia napis, a text-black na bg-yellow-500 daje czarny tekst na złotym tle. hover:bg-yellow-600 zmienia tło na ciemniejsze po najechaniu kursorem, a transition-colors robi to płynnie. Przycisk na razie niczego nie robi: akcję dostanie później.

Ściąga do czytania klas

Klasy Tailwinda układają się w rodziny. Gdy w kodzie od Claude trafisz na nieznaną, znajdź jej rodzinę:

  • Kolory: bg- to tło, text- tekst, border- ramka, na przykład bg-red-600, text-white, bg-black. Odcienie mają numery od 50 (najjaśniejszy) do 950 (najciemniejszy), więc hover:bg-red-700 przy bg-red-600 oznacza ciemniejsze tło po najechaniu.
  • Odstępy: p- to padding, czyli odstęp wewnętrzny, a m- margines, czyli odstęp zewnętrzny. Jednostka to 4 piksele: p-1 to 4px, p-2 8px, p-4 16px, p-8 32px. Litera po p albo m wybiera strony: px lewa i prawa, py góra i dół, pt góra, pr prawa, mt-8 margines górny 32px. mx-auto ustawia automatyczny margines po bokach i wyśrodkowuje blok o ograniczonej szerokości.
  • Tekst: rozmiary od najmniejszego to text-xs, text-sm, text-base (16px), text-lg, text-xl, potem text-2xl i większe. Grubość od najcieńszej: font-light, font-normal, font-medium, font-semibold, font-bold. Wyrównanie: text-left, text-center, text-right.
  • Układ: block, inline, flex i grid wybierają sposób wyświetlania, a hidden ukrywa element (display: none). We flexboxie flex-row to kierunek poziomy (domyślny), flex-col pionowy, a gap-4 daje 16 pikseli odstępu między dziećmi.
  • Wymiary: w-full to szerokość 100%, w-1/2 połowa, max-w-md największa szerokość 448px. h-screen to wysokość dokładnie całego ekranu (100vh), a min-h-screen co najmniej całego ekranu.
  • Ramki i rogi: border to ramka 1px, border-2 2px, border-red-500 jej kolor. rounded zaokrągla o 4px (w Tailwind 4 ta sama wartość ma też nazwę rounded-sm), rounded-lg mocniej, a rounded-full maksymalnie: przycisk staje się pigułką, a kwadrat kołem.

Nie ucz się tej listy na pamięć. Czytaj z nią kod od Claude, a po kilku sekcjach rodziny same zaczną się rozpoznawać.

Responsywność: najpierw telefon

Tailwind projektuje się od najmniejszego ekranu, czyli mobile first. Klasa bez przedrostka działa zawsze, a klasa z przedrostkiem breakpointu dopiero od podanej szerokości ekranu w górę:

  • sm: od 640px;
  • md: od 768px, na przykład tablet w pionie;
  • lg: od 1024px, mały laptop;
  • xl: od 1280px, monitor;
  • 2xl: od 1536px, duży monitor.

W nagłówku Claude napisał text-4xl md:text-6xl: na telefonie tytuł ma rozmiar 4xl, a od 768px w górę 6xl. Ten sam wzorzec zobaczysz w układach kart:

<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">

Na telefonie karty stoją w jednej kolumnie, od 768px w dwóch, a od 1024px w trzech. Zmień szerokość podglądu w edytorze poniżej i patrz, jak zmienia się liczba kolumn i rozmiar tekstu:

Kod do tej lekcji: index.html
<!DOCTYPE html>
<html lang="pl">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Tailwind Responsywność</title>
    <!-- Tailwind CSS 4 z CDN: wersja do nauki, nie do produkcji -->
    <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
</head>
<body class="bg-gray-100 p-8">
    <h1 class="text-3xl font-bold mb-8 text-center">
        Responsywność w Tailwind
    </h1>

    <!-- Mobile: 1 kolumna, Tablet: 2 kolumny, Desktop: 3 kolumny -->
    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
        <div class="bg-blue-500 text-white p-6 rounded-lg">
            <h2 class="text-xl font-bold mb-2">Karta 1</h2>
            <p>Zmień szerokość okna, żeby zobaczyć responsywność!</p>
        </div>
        <div class="bg-purple-500 text-white p-6 rounded-lg">
            <h2 class="text-xl font-bold mb-2">Karta 2</h2>
            <p>Mobile: 1 kolumna<br>Tablet (md): 2 kolumny<br>Desktop (lg): 3 kolumny</p>
        </div>
        <div class="bg-pink-500 text-white p-6 rounded-lg">
            <h2 class="text-xl font-bold mb-2">Karta 3</h2>
            <p>Breakpointy:<br>sm: 640px<br>md: 768px<br>lg: 1024px</p>
        </div>
    </div>

    <!-- Responsywny tekst -->
    <div class="mt-8 bg-white p-6 rounded-lg shadow">
        <p class="text-sm md:text-base lg:text-lg xl:text-xl">
            Ten tekst ma różne rozmiary:<br>
            Mobile: text-sm (14px)<br>
            Tablet: text-base (16px)<br>
            Laptop: text-lg (18px)<br>
            Desktop: text-xl (20px)
        </p>
    </div>
</body>
</html>

Ostatni przedrostek, który spotkasz w kodzie od Claude, to dark:. Klasa z nim działa tylko wtedy, gdy system użytkownika ma włączony tryb ciemny:

<div class="bg-white text-black dark:bg-gray-900 dark:text-white">Mapa skarbów</div>

W jasnym trybie div ma białe tło i czarny tekst, a w ciemnym tło ciemnoszare i tekst biały. Domyślnie Tailwind sprawdza to przez ustawienie systemu (prefers-color-scheme), a strona startowa z kreatora używa tego przedrostka w wielu miejscach, na przykład dark:bg-black.

Gdzie Tailwind siedzi w projekcie

Tailwind w nowym projekcie działa od pierwszej minuty: kreator z flagą --tailwind wszystko skonfigurował i niczego nie musisz doinstalowywać. W Tailwind 4 konfiguracja żyje w CSS. Pierwsza linia pliku app/globals.css to:

@import "tailwindcss";

Ta jedna linia wczytuje cały Tailwind. Niżej w tym pliku jest blok @theme inline, w którym projekt ustawia własne kolory i fonty. Tailwinda podłącza do budowania reguła Turbopacka w next.config.ts, którą czytałeś w poprzedniej lekcji.

W projekcie nie ma pliku tailwind.config.js ani postcss.config.mjs. Dyrektywy @tailwind base, @tailwind components i @tailwind utilities oraz plik tailwind.config.js to składnia wersji 3, a Tailwind 4 nie wykrywa już takiego pliku sam. Jeśli Claude zaproponuje któryś z nich, pisze z pamięci o starej wersji.

Przegląd kapitana

Zanim zatwierdzisz zmianę, sprawdź w diffie i w przeglądarce:

  1. Składnia wersji 4. W kodzie nie ma klas usuniętych w Tailwind 4, takich jak bg-opacity-50 (dziś bg-black/50), flex-grow-* (dziś grow-*) czy overflow-ellipsis (dziś text-ellipsis), ani nowego pliku tailwind.config.js.
  2. Wąski ekran. Zwęź okno przeglądarki do szerokości telefonu: nagłówek musi się mieścić, a tekst nie może dotykać krawędzi.
  3. Czytelność. Tekst wyraźnie odcina się od tła: jasnoszary opis na czarnym tle i czarny napis na złotym przycisku czytasz bez wysiłku.
  4. Hover to dodatek. W Tailwind 4 hover: działa tylko na urządzeniach, które mają kursor, więc na telefonie przycisk nie ściemnieje. Żadna ważna informacja nie może pojawiać się wyłącznie po najechaniu.

Typowy błąd agenta: miesza składnię Tailwinda 3 i 4 albo mimo zakazu dopisuje własny plik CSS. Drugi, częsty w JSX: goły apostrof w "Kraken's Call". npm run build go przepuszcza, ale npm run lint zgłasza błąd react/no-unescaped-entities. Dlatego w poleceniu były oba sprawdziany.

Następny krok

Jedna poprawka na jedno polecenie. Poproś na przykład: "W @app/page.tsx powiększ odstęp między opisem a przyciskiem, nic poza tym". W diffie powinna zmienić się jedna klasa, mt-8 na większą, na przykład mt-12. Gdy diff Ci odpowiada, poproś o commit. W edytorze poniżej czeka ta sama sekcja w zwykłym HTML: zmieniaj klasy i patrz, co robi każdy żagiel.

Pamiętaj: klasa Tailwinda to rozkaz dla jednego żagla; czytaj je po kolei, a zobaczysz cały okręt.

Kod do tej lekcji: index.html
<!DOCTYPE html>
<html lang="pl">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Kraken's Call - sekcja hero</title>
    <!-- Tailwind CSS 4 z CDN: wersja do nauki, nie do produkcji -->
    <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
</head>
<body>
    <!-- Ta sama sekcja, którą Claude napisał w app/page.tsx. W HTML zamiast className piszemy class -->
    <main class="flex min-h-screen items-center justify-center bg-black px-6">
        <div class="max-w-xl text-center">
            <h1 class="text-4xl font-bold text-red-600 md:text-6xl">
                Kraken's Call
            </h1>
            <p class="mt-4 text-lg text-gray-300">
                Piracka gra w przeglądarce: zbierz załogę i stań do walki z krakenem.
            </p>
            <button class="mt-8 rounded-lg bg-yellow-500 px-6 py-3 font-semibold text-black transition-colors hover:bg-yellow-600">
                Dołącz do załogi
            </button>
            <!-- Spróbuj: mt-8 zamień na mt-12, bg-yellow-500 na bg-red-600, a hover:bg-yellow-600 na hover:bg-red-700 -->
        </div>
    </main>
</body>
</html>

Widzisz błąd w tej lekcji?

Sprawdź się

Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.

  1. 1. Czym jest Tailwind CSS?

  2. 2. Która klasa Tailwind ustawia czerwone tło?

  3. 3. Który prefiks Tailwind stosuje styl od szerokości ekranu 768px w górę?

  4. 4. Która klasa Tailwind wyśrodkowuje elementy w poziomie wewnątrz flexboxa?

  5. 5. Co robi klasa hover:bg-red-700 w Tailwind?

  6. 6. Która klasa Tailwind ustawia szerokość elementu na 100%?

  7. 7. Co musisz zrobić, żeby używać Tailwind w Next.js, jeśli przy tworzeniu projektu wybrałeś Tailwind CSS (albo zalecane ustawienia domyślne)?

  8. 8. Co robi prefiks dark: w klasie Tailwind (np. dark:bg-gray-900)?

  9. 9. Która klasa Tailwind ustawia wysokość na cały ekran (100vh)?

  10. 10. Która klasa Tailwind wyśrodkowuje blok przez automatyczny margines lewy i prawy?

  11. 11. Która klasa Tailwind ukrywa element (display: none)?

Zadania praktyczne w grze

  • Edytor kodu

    Stwórz div z czarnym tłem (bg-black), białym tekstem (text-white) i paddingiem 16px (p-4). Wpisz w nim dowolny tekst.

  • Klikanie w kolejności

    Zbuduj klasę Tailwind ustawiającą biały kolor tekstu:

  • Układanie w pionie

    Uporządkuj klasy paddingu Tailwind od najmniejszego do największego:

  • Edytor kodu

    Stwórz div z klasami flex, items-center, justify-center i h-screen, a w środku umieść element z tekstem, np. <p>. Element ma stanąć na środku ekranu w pionie i w poziomie.

  • Układanie w pionie

    Uporządkuj breakpointy Tailwind od najmniejszego ekranu do największego:

  • Układanie w poziomie

    Ułóż kod czerwonego przycisku Tailwind (od lewej do prawej):

  • Edytor kodu

    Zbuduj piracki przycisk <button>: czerwone tło (np. bg-red-600), biały tekst (text-white), padding (np. px-6 py-3), zaokrąglone rogi (np. rounded-lg) i ciemniejsze tło po najechaniu myszką (np. hover:bg-red-700).

  • Klikanie w kolejności

    Zbuduj klasę Tailwind zaokrąglającą rogi na większy promień:

  • Układanie w poziomie

    Ułóż części klasy Tailwind dla czerwonego tła (od lewej do prawej):

  • Układanie w pionie

    Uporządkuj klasy grubości czcionki Tailwind od najcieńszej do najgrubszej:

  • Układanie w pionie

    Uporządkuj klasy rozmiaru tekstu Tailwind od najmniejszego do największego:

  • Układanie w pionie

    Uporządkuj klasy potrzebne do wyśrodkowania elementu w pionie i poziomie z Tailwind:

  • Układanie w poziomie

    Ułóż części klasy Tailwind dla marginesu top 32px (od lewej do prawej):

  • Układanie w pionie

    Uporządkuj kroki zmiany wyglądu strony z Claude Code:

  • Klikanie w kolejności

    Zbuduj klasę Tailwind dla bardzo dużego tekstu (extra large):

  • Klikanie w kolejności

    Zbuduj klasę Tailwind ustawiającą pionowy kierunek flexboxa:

  1. PytanieQuiz: Tailwind CSS
  2. PytanieQuiz: Tailwind kolory
  3. Zadanie z kodemPraktyka: Tailwind padding
  4. PytanieQuiz: Tailwind responsywność
  5. Kliknij w kolejnościSortowanie: Klasa białego tekstu
  6. Ułóż w kolejnościSortowanie: Skala paddingu Tailwind
  7. Zadanie z kodemPraktyka: Tailwind flexbox
  8. PytanieQuiz: Tailwind flexbox
  9. Ułóż w kolejnościSortowanie: Klasy responsywne Tailwind
  10. Ułóż w kolejnościSortowanie: Budowa przycisku Tailwind
  11. Zadanie z kodemPraktyka: Piracki przycisk
  12. PytanieQuiz: Tailwind hover
  13. Kliknij w kolejnościSortowanie: Klasa zaokrąglenia rogów
  14. PytanieQuiz: Tailwind szerokość
  15. Ułóż w kolejnościSortowanie: Klasa czerwonego tła
  16. Ułóż w kolejnościSortowanie: Grubość czcionki Tailwind
  17. Ułóż w kolejnościSortowanie: Rozmiary tekstu Tailwind
  18. PytanieQuiz: Next.js + Tailwind
  19. Ułóż w kolejnościSortowanie: Klasy wyśrodkowania flexbox
  20. PytanieQuiz: Tailwind dark mode
  21. Ułóż w kolejnościSortowanie: Klasa marginesu Tailwind
  22. PytanieQuiz: Tailwind wysokość ekranu
  23. Ułóż w kolejnościSortowanie: Styl od Claude Code
  24. PytanieQuiz: Tailwind wyśrodkowanie marginesem
  25. Kliknij w kolejnościSortowanie: Pełna klasa rozmiaru tekstu
  26. PytanieQuiz: Klasy display Tailwind
  27. Kliknij w kolejnościSortowanie: Kierunek flexbox w pionie

Przydatne artykuły