Kurs vibe coding z Claude Code · Moduł 2: Projekt Next.js z Claude Code
Landing page Kraken's Call od planu do pusha
W tej lekcji13
Ahoj! To ostatnia lekcja lokacji i jej główny projekt. Masz plan w SPEC.md, regulamin w CLAUDE.md i dziennik na GitHubie. Dziś zbudujesz cały landing page tak, jak będziesz budować każdy klon w tej podróży: małymi krokami, z dowodem po każdym z nich.
Problem: pięć kroków naraz to sztorm
Możesz napisać "wykonaj cały plan z SPEC.md". Claude zmieni wtedy cztery pliki w kilka minut, a jeśli build się wywróci, nie wiesz, który krok go zepsuł. /rewind cofnie wszystko naraz, także to, co działało. Jeden krok na jedno polecenie daje mały diff do przeczytania, jeden sprawdzian i jeden punkt powrotu.
Gdzie stoi okręt
Zacznij od stanu dziennika: wpisz w sesji ! git status i porównaj wynik z tym:
On branch feature/how-to-play
nothing to commit, working tree cleanTo gałąź z lekcji 1_5, na której leżą już commity ze SPEC.md i CLAUDE.md. "Working tree clean" znaczy, że lista w Source Control jest pusta, a ostatni dobry stan jest zapisany. Jeśli coś na niej czeka, najpierw zrób commit.
Pętla jednej sekcji
Każdy krok planu przejdzie tę samą pętlę. Znasz ją z lekcji 0_6, a dochodzi do niej dowód z builda:
1. Lista w Source Control pusta: dobry stan zapisany.
2. Polecenie: jeden krok planu z @SPEC.md.
3. Dowód: Claude uruchamia npm run build i pokazuje wynik.
4. Przegląd: diff w Source Control i strona w przeglądarce.
5. Dobrze? Commit z opisem. Źle? /rewind i mniejszy krok.Pętla zawsze kończy się zapisem albo cofnięciem, nigdy niezapisaną zmianą, na której buduje się następny krok. Serwer npm run dev trzymaj w drugim terminalu, żeby po każdym kroku zajrzeć do przeglądarki.
Krok 1: wspólny plik załogi
Sesja w trybie Manual, a polecenie krótsze niż kiedykolwiek wcześniej w tej lokacji:
Polecenie dla Claude Code:
Wykonaj krok 1 z części "Plan budowy" w @SPEC.md i nic więcej.
Na koniec uruchom npm run build i pokaż wynik.Cel, pliki, granice i sprawdzian są już w SPEC.md i CLAUDE.md, więc nie powtarzasz ich w każdej rozmowie. Tak procentuje praca z dwóch poprzednich lekcji.
Co napisał Claude
Otwórz w Cursorze nowy plik components/crew.tsx. Typy z lekcji 1_4 dostały słowo export:
export type CrewRole = "kapitan" | "sternik" | "kucharz" | "bosman";
export interface CrewMember {
name: string;
role: CrewRole;
level: number;
parrot?: string;
}export udostępnia nazwę innym plikom. Niżej stoją dane crew i komponent CrewCard, też z export, a ich treść się nie zmieniła. Plik app/crew/page.tsx zaczyna się teraz od jednej linii:
import { CrewCard, crew } from "@/components/crew";import pobiera nazwy z innego pliku, a nawiasy klamrowe wybierają te, które tamten plik eksportuje. @/ to alias z lekcji 1_2, czyli główny folder projektu. Strona /crew straciła trzydzieści linii, ale w przeglądarce ma wyglądać dokładnie tak samo: sprawdź to przed commitem.
Krok 2: hero i załoga na stronie głównej
Polecenie zostaje to samo, zmienia się tylko numer kroku. W app/page.tsx hero przestał być całą stroną i stał się pierwszą sekcją, a pod nim stoi sekcja załogi:
<section className="px-6 py-16">
<h2 className="text-center text-3xl font-bold text-red-600">Załoga</h2>
<div className="mx-auto mt-8 grid max-w-4xl grid-cols-1 gap-4 md:grid-cols-3">
{crew.map((member) => (
<CrewCard key={member.name} member={member} />
))}
</div>
</section><section> grupuje jedną część strony, a <h2> jest nagłówkiem drugiego stopnia, bo <h1> należy do nazwy gry w hero. Siatka i crew.map to ten sam kod co na stronie /crew: karty nie zostały skopiowane, tylko zaimportowane. Całą stronę obejmuje teraz <div className="bg-black text-white">, więc czarne tło ciągnie się przez wszystkie sekcje.
Krok 3: Jak grać
Trzy kroki gry Claude zapisał jako dane, tak samo jak załogę:
const steps = [
{ title: "Zbierz załogę", text: "Wybierz trzech piratów i przydziel im role na pokładzie." },
{ title: "Wyznacz kurs", text: "Zaplanuj trasę po mapie i omijaj mielizny." },
{ title: "Pokonaj krakena", text: "Wygraj bitwę, zanim kraken wciągnie okręt pod wodę." },
];Typu nie dopisał, bo TypeScript wywnioskuje go z wartości, o czym mówiła lekcja 1_4: każdy krok ma title i text jako tekst. Sekcja pokazuje kroki w liście numerowanej:
<ol className="mx-auto mt-8 grid max-w-4xl grid-cols-1 gap-4 md:grid-cols-3">
{steps.map((step, index) => (
<li key={step.title} className="rounded-lg bg-gray-900 p-6">
<p className="text-sm font-semibold text-yellow-400">Krok {index + 1}</p>
<h3 className="mt-2 text-xl font-bold">{step.title}</h3>
<p className="mt-2 text-gray-300">{step.text}</p>
</li>
))}
</ol><ol> to lista numerowana, a <li> jej element. index to numer kroku liczony od zera, dlatego na stronie stoi index + 1. Na telefonie kroki stoją jeden pod drugim, a od 768 pikseli w trzech kolumnach.
Kroki 4 i 5: stopka i metadane
Stopka stoi pod <main>, bo nie należy do głównej treści strony:
<footer className="border-t border-gray-800 px-6 py-8 text-center text-sm text-gray-400">
<p>Kraken's Call, 2026</p>
<a href="https://github.com/TWOJ-LOGIN/krakens-call" className="mt-2 inline-block text-yellow-400 underline hover:text-yellow-300">
Kod gry na GitHubie
</a>
</footer><a> z atrybutem href to link, a TWOJ-LOGIN zamieniasz na swój login. Klasa underline zostaje na stałe, bo hover: nie działa na telefonie, a link ma wyglądać jak link bez najeżdżania. Krok 5 zmienia w app/layout.tsx tytuł w metadata na "Kraken's Call", żeby karta przeglądarki nie mówiła "Create Next App", oraz lang="en" na lang="pl": według MDN atrybut lang pozwala czytnikom ekranu wymawiać tekst we właściwym języku. Ten kod sprawdziłem w kopii projektu: npm run build, npm run lint i npx tsc --noEmit przechodzą bez błędów.
Zepsuj i odzyskaj
Raz zepsuj build celowo, żeby siatka bezpieczeństwa nie była teorią. Po commicie dowolnego kroku wydaj polecenie:
W @components/crew.tsx zmień w interfejsie CrewMember nazwę pola level
na rank. Zmień tylko tę jedną linię i nie uruchamiaj żadnych komend.Potem uruchom sprawdzian sam, wpisując ! npm run build. Wynik kończy się mniej więcej tak:
✓ Compiled successfully in 308ms
Running TypeScript ...
components/crew.tsx(11,42): error TS2353: Object literal may only specify known properties, and 'level' does not exist in type 'CrewMember'.
components/crew.tsx(25,39): error TS2339: Property 'level' does not exist on type 'CrewMember'.
Failed to type check."Compiled successfully" nie oznacza sukcesu: dopiero sprawdzanie typów odkryło, że dane i karta nadal używają level, a umowa już go nie zna. Wpisz /rewind, wybierz to polecenie i Restore code. Lista w Source Control znów jest pusta, a ! npm run build przechodzi. Gdy błąd jest prawdziwy, poproś Claude, żeby przeczytał komunikat i naprawił tylko jego przyczynę. Po dwóch nieudanych poprawkach nie dokładaj trzeciej: wróć /rewind do dobrego stanu i wydaj mniejsze polecenie.
Czego /rewind tu nie cofnie
Checkpoint pamięta pliki, które Claude zmienia swoimi narzędziami do edycji. W tym projekcie granice z lekcji 0_6 wyglądają tak:
- paczka z npm install:
package.jsonipackage-lock.jsonzmienia komenda, więc jeśli Claude nie edytował ich wcześniej swoim narzędziem,/rewindich nie przywróci; zrobi togit restore package.json package-lock.json; - commit:
git committo też komenda, więc zapis zostaje w historii nawet po cofnięciu plików; - push: to, co poszło na GitHub, opuściło Twój komputer.
Dlatego commit robisz przed ryzykownym krokiem, a push dopiero po przeglądzie.
Push na GitHub
Gdy każdy z pięciu kroków ma swój commit, poproś o wlanie gałęzi i wysyłkę:
Polecenie dla Claude Code:
Wlej gałąź feature/how-to-play do main i wyślij main na GitHub.
Pokaż komendy, zanim je uruchomisz, a na koniec wynik git log --oneline.Claude poprosi o zgodę na trzy komendy:
git switch main
git merge feature/how-to-play
git pushgit switch main wraca na główną gałąź, a git merge wlewa do niej commity gałęzi funkcji. Na main nic się w tym czasie nie zmieniło, więc Git po prostu przesuwa ją do przodu i wypisze "Fast-forward". Po wlaniu git status mówi "Your branch is ahead of 'origin/main'", czyli main zna swoje repozytorium na GitHubie i wystarczy zwykłe git push. Przed zgodą sprawdź, że nigdzie nie stoi --force.
Lista kontrolna kapitana
Zanim wyślesz link mentorowi, przejdź listę:
- Build:
npm run build,npm run lintinpx tsc --noEmitprzechodzą, a wyniki widziałeś sam. - Uczciwe typy: w diffach nie ma
anyani@ts-ignore. - Wąski ekran: po zwężeniu okna do szerokości telefonu karty i kroki stoją jeden pod drugim, a tekst nie dotyka krawędzi.
- Kontrast: każdy tekst wyraźnie odcina się od tła, a link jest podkreślony.
- Sekrety: w repozytorium nie ma
.env, bo.gitignorez kreatora pomija każdy plik zaczynający się od.env. - Dziennik:
git log --onelinepokazuje mały commit na każdy krok, a tytuły mówią, co się zmieniło.
Typowy błąd agenta w tej pętli: robi więcej, niż prosiłeś, na przykład przy kroku 3 "przy okazji" dodaje stopkę. Zobaczysz to w Source Control jako diff większy, niż zapowiadał krok. Odpowiedz /rewind i powtórz polecenie z dopiskiem "tylko krok 3".
Następny krok
Otwórz repozytorium w przeglądarce i wklej jego adres w zadaniu dla mentora. Sprawdzi SPEC.md z planem, krótki CLAUDE.md z importem @AGENTS.md, commity małymi krokami i build bez błędów. W kolejnej lokacji zaczniesz klon Twittera i każdą jego funkcję przeprowadzisz przez tę samą pętlę. W edytorze poniżej czeka gotowy landing page w HTML: zwęź podgląd i przejdź listę kontrolną na własne oczy.
Pamiętaj: każdy klon w tej podróży zbudujesz tą samą pętlą, a dziś przepłynąłeś ją pierwszy raz od portu do portu.
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</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-black text-white">
<!-- Landing page z lekcji 1_8 w zwykłym HTML. W projekcie Next.js to app/page.tsx z className -->
<main>
<!-- Krok 2: hero jako pierwsza sekcja -->
<section class="flex min-h-screen items-center justify-center 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>
</div>
</section>
<!-- Krok 2: sekcja załogi, te same karty co na stronie /crew -->
<section class="px-6 py-16">
<h2 class="text-center text-3xl font-bold text-red-600">Załoga</h2>
<div class="mx-auto mt-8 grid max-w-4xl grid-cols-1 gap-4 md:grid-cols-3">
<article class="rounded-lg border border-yellow-500 bg-gray-900 p-6">
<h3 class="text-xl font-bold">Anne Bonny</h3>
<p class="mt-2 text-gray-300">kapitan, poziom 10</p>
<p class="mt-2 text-yellow-400">Papuga: Kapitan Pióro</p>
</article>
<article class="rounded-lg border border-yellow-500 bg-gray-900 p-6">
<h3 class="text-xl font-bold">Jack Rackham</h3>
<p class="mt-2 text-gray-300">sternik, poziom 7</p>
</article>
<article class="rounded-lg border border-yellow-500 bg-gray-900 p-6">
<h3 class="text-xl font-bold">Mary Read</h3>
<p class="mt-2 text-gray-300">kucharz, poziom 5</p>
</article>
</div>
</section>
<!-- Krok 3: Jak grać, lista numerowana -->
<section class="px-6 py-16">
<h2 class="text-center text-3xl font-bold text-red-600">Jak grać</h2>
<ol class="mx-auto mt-8 grid max-w-4xl grid-cols-1 gap-4 md:grid-cols-3">
<li class="rounded-lg bg-gray-900 p-6">
<p class="text-sm font-semibold text-yellow-400">Krok 1</p>
<h3 class="mt-2 text-xl font-bold">Zbierz załogę</h3>
<p class="mt-2 text-gray-300">Wybierz trzech piratów i przydziel im role na pokładzie.</p>
</li>
<li class="rounded-lg bg-gray-900 p-6">
<p class="text-sm font-semibold text-yellow-400">Krok 2</p>
<h3 class="mt-2 text-xl font-bold">Wyznacz kurs</h3>
<p class="mt-2 text-gray-300">Zaplanuj trasę po mapie i omijaj mielizny.</p>
</li>
<li class="rounded-lg bg-gray-900 p-6">
<p class="text-sm font-semibold text-yellow-400">Krok 3</p>
<h3 class="mt-2 text-xl font-bold">Pokonaj krakena</h3>
<p class="mt-2 text-gray-300">Wygraj bitwę, zanim kraken wciągnie okręt pod wodę.</p>
</li>
</ol>
</section>
</main>
<!-- Krok 4: stopka pod main, link podkreślony na stałe -->
<footer class="border-t border-gray-800 px-6 py-8 text-center text-sm text-gray-400">
<p>Kraken's Call, 2026</p>
<a href="https://github.com/TWOJ-LOGIN/krakens-call" class="mt-2 inline-block text-yellow-400 underline hover:text-yellow-300">
Kod gry na GitHubie
</a>
</footer>
<!-- Lista kontrolna: zwęź podgląd do szerokości telefonu. Karty i kroki stoją jeden pod drugim? Tekst nie dotyka krawędzi? -->
</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. Po kroku planu npm run build kończy się błędem typów. Co robisz najpierw?
2. Claude melduje: krok gotowy, npm run build przechodzi. Czego ten build za Ciebie nie sprawdzi?
3. Dlaczego landing page budujesz jednym krokiem planu na jedno polecenie, a nie całym planem naraz?
Zadania praktyczne w grze
- Układanie w pionie
Ułóż kroki ćwiczenia, w którym celowo psujesz build i wracasz do działającej wersji:
- Klikanie w kolejności
Kliknij elementy po kolei, aby złożyć komendę, która wlewa gałąź feature/how-to-play do bieżącej gałęzi: