Kurs vibe coding z Claude Code · Moduł 2: Projekt Next.js z Claude Code
Tailwind CSS: czytaj klasy, które pisze Claude
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'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. ' 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ładbg-red-600,text-white,bg-black. Odcienie mają numery od 50 (najjaśniejszy) do 950 (najciemniejszy), więchover:bg-red-700przybg-red-600oznacza ciemniejsze tło po najechaniu. - Odstępy:
p-to padding, czyli odstęp wewnętrzny, am-margines, czyli odstęp zewnętrzny. Jednostka to 4 piksele:p-1to 4px,p-28px,p-416px,p-832px. Litera popalbomwybiera strony:pxlewa i prawa,pygóra i dół,ptgóra,prprawa,mt-8margines górny 32px.mx-autoustawia 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, potemtext-2xli 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,flexigridwybierają sposób wyświetlania, ahiddenukrywa element (display: none). We flexboxieflex-rowto kierunek poziomy (domyślny),flex-colpionowy, agap-4daje 16 pikseli odstępu między dziećmi. - Wymiary:
w-fullto szerokość 100%,w-1/2połowa,max-w-mdnajwiększa szerokość 448px.h-screento wysokość dokładnie całego ekranu (100vh), amin-h-screenco najmniej całego ekranu. - Ramki i rogi:
borderto ramka 1px,border-22px,border-red-500jej kolor.roundedzaokrągla o 4px (w Tailwind 4 ta sama wartość ma też nazwęrounded-sm),rounded-lgmocniej, arounded-fullmaksymalnie: 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:
- 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-*) czyoverflow-ellipsis(dziśtext-ellipsis), ani nowego plikutailwind.config.js. - 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.
- 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.
- 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. Czym jest Tailwind CSS?
2. Która klasa Tailwind ustawia czerwone tło?
3. Który prefiks Tailwind stosuje styl od szerokości ekranu 768px w górę?
4. Która klasa Tailwind wyśrodkowuje elementy w poziomie wewnątrz flexboxa?
5. Co robi klasa hover:bg-red-700 w Tailwind?
6. Która klasa Tailwind ustawia szerokość elementu na 100%?
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. Co robi prefiks dark: w klasie Tailwind (np. dark:bg-gray-900)?
9. Która klasa Tailwind ustawia wysokość na cały ekran (100vh)?
10. Która klasa Tailwind wyśrodkowuje blok przez automatyczny margines lewy i prawy?
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:
Zadania po tej lekcji
- PytanieQuiz: Tailwind CSS
- PytanieQuiz: Tailwind kolory
- Zadanie z kodemPraktyka: Tailwind padding
- PytanieQuiz: Tailwind responsywność
- Kliknij w kolejnościSortowanie: Klasa białego tekstu
- Ułóż w kolejnościSortowanie: Skala paddingu Tailwind
- Zadanie z kodemPraktyka: Tailwind flexbox
- PytanieQuiz: Tailwind flexbox
- Ułóż w kolejnościSortowanie: Klasy responsywne Tailwind
- Ułóż w kolejnościSortowanie: Budowa przycisku Tailwind
- Zadanie z kodemPraktyka: Piracki przycisk
- PytanieQuiz: Tailwind hover
- Kliknij w kolejnościSortowanie: Klasa zaokrąglenia rogów
- PytanieQuiz: Tailwind szerokość
- Ułóż w kolejnościSortowanie: Klasa czerwonego tła
- Ułóż w kolejnościSortowanie: Grubość czcionki Tailwind
- Ułóż w kolejnościSortowanie: Rozmiary tekstu Tailwind
- PytanieQuiz: Next.js + Tailwind
- Ułóż w kolejnościSortowanie: Klasy wyśrodkowania flexbox
- PytanieQuiz: Tailwind dark mode
- Ułóż w kolejnościSortowanie: Klasa marginesu Tailwind
- PytanieQuiz: Tailwind wysokość ekranu
- Ułóż w kolejnościSortowanie: Styl od Claude Code
- PytanieQuiz: Tailwind wyśrodkowanie marginesem
- Kliknij w kolejnościSortowanie: Pełna klasa rozmiaru tekstu
- PytanieQuiz: Klasy display Tailwind
- Kliknij w kolejnościSortowanie: Kierunek flexbox w pionie