Kurs vibe coding z Claude Code · Moduł 13: Klon Twitcha
Księga załogi: strona kanału, obserwowanie i wsparcie
W tej lekcji8
Odtwarzacz i czat działają ale widz, który trafi na kanał, nie wie jeszcze, czyj to pokład. Streamer potrzebuje wizytówki: baneru, awatara, opisu i liczby obserwujących. Widz chce dwóch przycisków: Obserwuj, żeby nie zgubić kanału, i Wesprzyj, żeby dorzucić się do rejsów. Do tego kanał nie nadaje przez całą dobę, więc strona musi mieć sensowny stan offline. W tej lekcji Claude zbuduje to wszystko, a Ty dopilnujesz dwóch rzeczy, przy których agent lubi zgadywać: zakładek i pieniędzy.
Czego się nauczysz
- zapisać w
CLAUDE.mddwie konwencje, zanim Claude napisze pierwszą linię strony kanału; - przeczytać jeden wspólny komponent zakładek zamiast piątej kopii tego samego kodu;
- zbudować okno wsparcia, które niczego nie pobiera i mówi o tym wprost;
- sprawdzić stan offline i okno wsparcia w przeglądarce, łącznie z klawiszem Esc.
Najpierw konwencje, potem kod
Zakładki budowałeś już kilka razy: na kanale YouTube w lekcji 5_3, w gildiach Reddita, w kronice. Każda kolejna kopia to miejsce, w którym poprawka trafi do jednej strony, a w drugiej zostanie stary błąd. Agent nie pamięta poprzednich projektów i chętnie napisze zakładki od nowa, prosto w stronie. Lekcja 1_7 dała Ci narzędzie na takie powtórki: CLAUDE.md, plik, który Claude czyta na początku każdej sesji. Otwórz go w Cursorze i dopisz do sekcji konwencji dwie linie:
- Zakładki tylko przez components/Tabs.tsx. Aktywna zakładka żyje w adresie (?tab=), jak w lekcji 5_3. Nie kopiuj kodu zakładek do stron.
- Płatności nie implementujemy. Poziomy wsparcia i ceny trzymaj tylko w lib/support.ts.Pierwsza linia zamienia zwyczaj w zasadę. Druga zamyka temat, przy którym zgadywanie jest najdroższe. Prawdziwe płatności to umowa z operatorem, zwroty, podatki i dane kart, a nie jeden przycisk. Dopóki ich nie ma, okno wsparcia ma tylko pokazać, co planujesz.
Polecenie dla Claude Code
Polecenie dla Claude Code:
Rozbuduj stronę /channel/[handle]: nad odtwarzaczem nagłówek kanału
(baner, awatar, nazwa, liczba obserwujących), przyciski Obserwuj
i Wesprzyj, pod nim zakładki Start, Nagrania i O kanale. Przeczytaj
CLAUDE.md i trzymaj się konwencji. Obserwuj na razie przełącza stan
w przeglądarce. Wesprzyj otwiera okno z poziomami z lib/support.ts
i nieaktywnym przyciskiem "Wkrótce", bez żadnego żądania do serwera.
Gdy kanał jest offline, zakładka Start pokazuje komunikat i link do
nagrań zamiast odtwarzacza i czatu. Gotowe, gdy npm run lint,
npx tsc --noEmit i npm run build przejdą bez błędów.Polecenie powtarza zasadę z CLAUDE.md jednym zdaniem i dokłada to, czego plik nie mówi: co ma robić każdy przycisk i jak wygląda kanał offline.
Co napisał Claude: jeden komponent zakładek
Otwórz components/Tabs.tsx. To Server Component bez stanu, bo zakładki są linkami, jak na kanale z lekcji 5_3:
// components/Tabs.tsx
export function pickTab<K extends string>(tabs: readonly Tab<K>[], value: unknown): K {
return tabs.find((tab) => tab.key === value)?.key ?? tabs[0].key;
}K to parametr typu: komponent nie zna z góry nazw zakładek, przyjmuje je od strony. pickTab zamienia to, co przyszło w adresie, na znaną zakładkę. Adres ?tab=cokolwiek daje pierwszą zakładkę zamiast pustej strony. Sam pasek to lista linków z aria-current="page" na aktywnej, z ramką border-transparent na pozostałych, znaną z lekcji 5_3. Strona kanału podaje tylko listę:
// app/channel/[handle]/page.tsx
const CHANNEL_TABS = [
{ key: "home", label: "Start" },
{ key: "videos", label: "Nagrania" },
{ key: "about", label: "O kanale" },
] as const;as const zamraża klucze jako dokładne napisy, więc active ma typ "home" | "videos" | "about", a literówka w active === "vidoes" nie przejdzie przez tsc. Bez as const klucze stałyby się zwykłym string i porównanie z dowolnym tekstem kompilowałoby się bez słowa. Dalej strona czyta tab przez await searchParams, liczy const active = pickTab(CHANNEL_TABS, tab) i rysuje <Tabs tabs={CHANNEL_TABS} active={active} basePath={...} />.
Co napisał Claude: wsparcie bez udawanej płatności
Otwórz lib/support.ts. Trzy poziomy wsparcia opisuje jeden typ:
// lib/support.ts
// Poziomy wsparcia w naszym klonie. Nazwy i ceny ustalamy sami: to nie są ceny Twitcha.
export interface SupportTier {
level: 1 | 2 | 3;
name: string;
pricePln: number;
perks: string[];
}Agent lubi opisać każdy poziom osobnym typem, czyli trzy razy ten sam kształt. Jeden typ z polem level mówi to samo raz. Pod typem stoi tablica SUPPORT_TIERS z nazwami Majtek, Bosman i Kapitan oraz funkcja formatPrice, która używa Intl.NumberFormat("pl-PL", { style: "currency", currency: "PLN" }). Ceny są wymyślone dla klonu i stoją w jednym pliku. Gdy zmienisz je jutro, zmienisz je w jednym miejscu. Teraz okno, components/SupportDialog.tsx:
// components/SupportDialog.tsx
<button type="button" disabled className="mt-2 rounded bg-zinc-700 px-3 py-1 text-sm text-zinc-400">
Wkrótce
</button>Przycisk przy każdym poziomie jest wyłączony, a pod listą stoi zdanie "Płatności jeszcze nie działają. Nic nie zostanie pobrane." Okno otwiera dialogRef.current?.showModal(). MDN opisuje, że showModal() pokazuje okno nad resztą strony, z tłem ::backdrop, a reszta strony przestaje reagować. Klawisz Esc zamyka okno, bo według MDN jest prośbą o zamknięcie, która wywołuje zdarzenie cancel. Okno ma klasę m-auto, bo Tailwind 4 zeruje marginesy. U nas bez niej okno stanęło w lewym górnym rogu strony.
Co napisał Claude: kanał offline
Kanał offline ma w danych live: null, typ z lekcji 12_1. Odtwarzacz i czat Claude przeniósł do komponentu LivePanel, więc strona wybiera widok jednym warunkiem:
// app/channel/[handle]/page.tsx
{active === "home" &&
(channel.live ? <LivePanel channel={channel} /> : <OfflinePanel channel={channel} />)}OfflinePanel ma te same proporcje co odtwarzacz (aspect-video), więc układ nie skacze, gdy kanał zaczyna albo kończy nadawanie. Pokazuje nazwę kanału, zdanie o przerwie i link do zakładki Nagrania. Typ LiveStream | null robi tu dobrą robotę: kanał offline nie może mieć liczby widzów ani tytułu transmisji, bo nie ma czego czytać.
Przycisk Obserwuj to components/FollowButton.tsx z jednym useState i atrybutem aria-pressed, który według MDN opisuje stan przycisku przełącznika: wciśnięty albo nie. Stan żyje tylko w tej karcie przeglądarki. Zapis na serwerze dla zalogowanego widza to robota na później, z logowaniem z lekcji 8_5.
Przegląd kapitana
- Jedne zakładki. Wyszukaj w projekcie
aria-current. Wynik ma wskazaćcomponents/Tabs.tsx, a nie stronę kanału. Typowy błąd agenta to piąta kopia zakładek wpisana prosto w stronę, mimo konwencji. Gdy ją znajdziesz, odpowiedz: "Przeczytaj CLAUDE.md i użyj Tabs". - Żadnych żądań płatności. Wyszukaj
fetch(wcomponents/. Agent potrafi dopisaćfetch("/api/pay")do trasy, której nie ma, i komunikat "Dziękujemy za wsparcie!". To kłamstwo wobec widza. - Ceny w jednym miejscu. Wyszukaj
złipricePln. Liczby mają stać tylko wlib/support.ts. - Liczby po polsku.
Intl.NumberFormat("pl-PL")zapisał u nas 12480 jako "12 480", a 3120 bez spacji. Tak działa polski format liczb wIntl: cztery cyfry zostają razem. To nie błąd, tylko reguła. - Przeglądarka.
npm run dev, potem/channel/kapitan-redbeard: otwórz okno wsparcia, sprawdź, czy stoi na środku, i zamknij je klawiszem Esc. Potem/channel/papuga-polai stan offline. U nas okno zamknęło się po Esc, a lista żądań sieci nie pokazała żadnego wywołaniafetch.
Następny krok
Gdy przegląd przejdzie, poproś o commit "Strona kanału z zakładkami i oknem wsparcia". Potem mały krok: "Dodaj zakładkę Harmonogram z dniami transmisji kanału, przez Tabs". Jeśli Claude sięgnie po Tabs sam, konwencja działa. Jeśli nie, dopisz do CLAUDE.md jeszcze krótszą wersję zasady. W edytorze poniżej czeka strona kanału w miniaturze, z przełącznikiem online i offline i oknem wsparcia.
Zapamiętaj: księga załogi mówi, kto stoi na pokładzie, a skarbiec zostaje zamknięty, dopóki nie przyjdzie prawdziwy skarbnik; zgadujący duch nie dostaje klucza.
Kod do tej lekcji: App.tsx
// Strona kanału w miniaturze: jeden komponent zakładek, stan offline i okno wsparcia bez płatności
import { useRef, useState } from 'react';
// Poziomy wsparcia w naszym klonie. Nazwy i ceny ustalamy sami: to nie są ceny Twitcha.
interface SupportTier {
level: 1 | 2 | 3;
name: string;
pricePln: number;
perks: string[];
}
const SUPPORT_TIERS: SupportTier[] = [
{ level: 1, name: 'Majtek', pricePln: 10, perks: ['Odznaka przy nicku na czacie'] },
{ level: 2, name: 'Bosman', pricePln: 25, perks: ['Odznaka przy nicku na czacie', 'Dodatkowe emotki'] },
{ level: 3, name: 'Kapitan', pricePln: 60, perks: ['Odznaka przy nicku na czacie', 'Dodatkowe emotki', 'Imię w napisach końcowych'] },
];
const priceFormat = new Intl.NumberFormat('pl-PL', { style: 'currency', currency: 'PLN' });
const countFormat = new Intl.NumberFormat('pl-PL');
interface Tab<K extends string> {
key: K;
label: string;
}
// W edytorze nie ma paska adresu, więc zakładka żyje w stanie rodzica (lekcja 5_3)
function Tabs<K extends string>({ tabs, active, onSelect }: { tabs: readonly Tab<K>[]; active: K; onSelect: (key: K) => void }) {
return (
<nav aria-label="Zakładki" className="flex gap-1 border-b border-zinc-800">
{tabs.map((tab) => (
<button
key={tab.key}
type="button"
onClick={() => onSelect(tab.key)}
aria-current={tab.key === active ? 'page' : undefined}
className={tab.key === active ? 'border-b-2 border-purple-500 px-4 py-2 font-semibold' : 'border-b-2 border-transparent px-4 py-2 text-zinc-400'}
>
{tab.label}
</button>
))}
</nav>
);
}
const CHANNEL_TABS = [
{ key: 'home', label: 'Start' },
{ key: 'videos', label: 'Nagrania' },
{ key: 'about', label: 'O kanale' },
] as const;
type ChannelTab = (typeof CHANNEL_TABS)[number]['key'];
function SupportDialog({ channelName }: { channelName: string }) {
const dialogRef = useRef<HTMLDialogElement>(null);
return (
<>
<button type="button" onClick={() => dialogRef.current?.showModal()} className="rounded bg-zinc-100 px-4 py-2 font-semibold text-zinc-900">
Wesprzyj
</button>
<dialog ref={dialogRef} aria-labelledby="support-title" className="m-auto w-full max-w-md rounded-lg bg-zinc-900 p-5 text-zinc-100 backdrop:bg-black/70">
<h2 id="support-title" className="text-lg font-bold">Wesprzyj kanał {channelName}</h2>
<ul className="mt-4 space-y-3">
{SUPPORT_TIERS.map((tier) => (
<li key={tier.level} className="rounded border border-zinc-700 p-3">
<p className="font-semibold">{tier.name} · {priceFormat.format(tier.pricePln)} miesięcznie</p>
<p className="text-sm text-zinc-400">{tier.perks.join(', ')}</p>
<button type="button" disabled className="mt-2 rounded bg-zinc-700 px-3 py-1 text-sm text-zinc-400">
Wkrótce
</button>
</li>
))}
</ul>
<p className="mt-4 text-sm text-zinc-400">Płatności jeszcze nie działają. Nic nie zostanie pobrane.</p>
<button type="button" onClick={() => dialogRef.current?.close()} className="mt-4 rounded bg-zinc-700 px-4 py-2">
Zamknij
</button>
</dialog>
</>
);
}
export default function App() {
const [active, setActive] = useState<ChannelTab>('home');
const [live, setLive] = useState(true);
const [following, setFollowing] = useState(false);
return (
<div className="min-h-screen space-y-4 bg-zinc-950 p-4 text-zinc-100">
<div className="aspect-[6/1] rounded-lg bg-linear-to-r from-sky-700 to-amber-500" />
<div className="flex flex-wrap items-center gap-3">
<div className="size-16 rounded-full bg-amber-600" />
<div className="mr-auto">
<h1 className="text-xl font-bold">Kapitan Redbeard</h1>
<p className="text-sm text-zinc-400">{countFormat.format(12480)} obserwujących</p>
</div>
<button
type="button"
aria-pressed={following}
onClick={() => setFollowing((f) => !f)}
className={following ? 'rounded bg-zinc-700 px-4 py-2 font-semibold' : 'rounded bg-purple-600 px-4 py-2 font-semibold'}
>
{following ? 'Obserwujesz' : 'Obserwuj'}
</button>
<SupportDialog channelName="Kapitan Redbeard" />
</div>
<Tabs tabs={CHANNEL_TABS} active={active} onSelect={setActive} />
{active === 'home' &&
(live ? (
<section className="grid aspect-video place-content-center rounded-lg bg-black text-center">
<span className="mx-auto rounded bg-red-600 px-2 py-1 text-xs font-bold">NA ŻYWO</span>
<p className="mt-2">Rejs przez Morze Kodu: budujemy czat</p>
</section>
) : (
<section className="grid aspect-video place-content-center gap-3 rounded-lg bg-zinc-900 p-6 text-center">
<p className="text-lg font-semibold">Kapitan Redbeard jest teraz offline</p>
<p className="text-zinc-400">Załoga odpoczywa po rejsie. Obejrzyj nagrania z poprzednich transmisji.</p>
<button type="button" onClick={() => setActive('videos')} className="text-purple-400 underline">
Przejdź do nagrań
</button>
</section>
))}
{active === 'videos' && <p className="text-zinc-400">Rejs 1: player i czat</p>}
{active === 'about' && <p>Codzienne rejsy przez kod: budujemy klony aplikacji z Claude Code.</p>}
<label className="flex items-center gap-2 text-sm">
<input type="checkbox" checked={live} onChange={(e) => setLive(e.target.checked)} />
Kanał nadaje (odznacz, żeby zobaczyć stan offline)
</label>
</div>
);
}Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Gdzie w Live from the Deck stoją nazwy i ceny poziomów wsparcia?
2. Co robi przycisk przy poziomie wsparcia w oknie Wesprzyj, dopóki płatności nie istnieją?
To 2 z 6 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Klikanie w kolejności
Zbuduj wywołanie, które otwiera okno wsparcia jako okno modalne
- Układanie w pionie
Uporządkuj części strony kanału od góry strony:
- Układanie w pionie
Uporządkuj pracę nad stroną kanału z lekcji:
- Edytor kodu
Zbuduj stronę kanału streamera
- Klikanie w kolejności
Zbuduj linię strony kanału, która zamienia parametr tab z adresu na znaną zakładkę
- Edytor kodu
Stwórz kartę live streamu
Zadania po tej lekcji
- PytanieQuiz: gdzie stoją ceny
- PytanieQuiz: przycisk Wkrótce
- Kliknij w kolejnościBudowanie: otwarcie okna wsparcia
- Ułóż w kolejnościSortowanie: strona kanału od góry
- Ułóż w kolejnościSortowanie: konwencja przed kodem
- Zadanie z kodemPraktyka: Channel page
- PytanieQuiz: as const przy zakładkach
- PytanieQuiz: nieznana zakładka w adresie
- Kliknij w kolejnościBudowanie: zakładka z adresu
- Zadanie z kodemPraktyka: Stream card
- PytanieQuiz: stan offline kanału
- PytanieQuiz: okno w rogu strony