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

Landing page Kraken's Call od planu do pusha

8 min czytania ·
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 clean

To 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&apos;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.json i package-lock.json zmienia komenda, więc jeśli Claude nie edytował ich wcześniej swoim narzędziem, /rewind ich nie przywróci; zrobi to git restore package.json package-lock.json;
  • commit: git commit to 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 push

git 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ę:

  1. Build: npm run build, npm run lint i npx tsc --noEmit przechodzą, a wyniki widziałeś sam.
  2. Uczciwe typy: w diffach nie ma any ani @ts-ignore.
  3. Wąski ekran: po zwężeniu okna do szerokości telefonu karty i kroki stoją jeden pod drugim, a tekst nie dotyka krawędzi.
  4. Kontrast: każdy tekst wyraźnie odcina się od tła, a link jest podkreślony.
  5. Sekrety: w repozytorium nie ma .env, bo .gitignore z kreatora pomija każdy plik zaczynający się od .env.
  6. Dziennik: git log --oneline pokazuje 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. 1. Po kroku planu npm run build kończy się błędem typów. Co robisz najpierw?

  2. 2. Claude melduje: krok gotowy, npm run build przechodzi. Czego ten build za Ciebie nie sprawdzi?

  3. 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:

  1. PytanieQuiz: Build nie przechodzi
  2. Ułóż w kolejnościSortowanie: Zepsuj i odzyskaj
  3. PytanieQuiz: Czego build nie sprawdzi
  4. Kliknij w kolejnościSortowanie: Komenda wlania gałęzi
  5. PytanieQuiz: Jeden krok na polecenie
  6. Projekt do wysłaniaWyślij landing page Kraken's Call
  7. WideoPodsumowanie modułu

Przydatne artykuły