Kurs vibe coding z Claude Code · Moduł 13: Klon Twitcha

Księga załogi: strona kanału, obserwowanie i wsparcie

6 min czytania
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.md dwie 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

  1. 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".
  2. Żadnych żądań płatności. Wyszukaj fetch( w components/. Agent potrafi dopisać fetch("/api/pay") do trasy, której nie ma, i komunikat "Dziękujemy za wsparcie!". To kłamstwo wobec widza.
  3. Ceny w jednym miejscu. Wyszukaj zł i pricePln. Liczby mają stać tylko w lib/support.ts.
  4. Liczby po polsku. Intl.NumberFormat("pl-PL") zapisał u nas 12480 jako "12 480", a 3120 bez spacji. Tak działa polski format liczb w Intl: cztery cyfry zostają razem. To nie błąd, tylko reguła.
  5. 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-pola i stan offline. U nas okno zamknęło się po Esc, a lista żądań sieci nie pokazała żadnego wywołania fetch.

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. 1. Gdzie w Live from the Deck stoją nazwy i ceny poziomów wsparcia?

  2. 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

  1. PytanieQuiz: gdzie stoją ceny
  2. PytanieQuiz: przycisk Wkrótce
  3. Kliknij w kolejnościBudowanie: otwarcie okna wsparcia
  4. Ułóż w kolejnościSortowanie: strona kanału od góry
  5. Ułóż w kolejnościSortowanie: konwencja przed kodem
  6. Zadanie z kodemPraktyka: Channel page
  7. PytanieQuiz: as const przy zakładkach
  8. PytanieQuiz: nieznana zakładka w adresie
  9. Kliknij w kolejnościBudowanie: zakładka z adresu
  10. Zadanie z kodemPraktyka: Stream card
  11. PytanieQuiz: stan offline kanału
  12. PytanieQuiz: okno w rogu strony

Przydatne artykuły