Kurs vibe coding z Claude Code · Moduł 10: Klon TikToka

Feed For You: jeden klip na ekran, sprawdzany uchem

7 min czytania
W tej lekcji11

Ahoj! Załoga nagrywa krótkie klipy z każdej wyprawy: skrzynia pod palmą, abordaż o świcie, cień krakena pod wodą. Dziś te klipy giną w folderze na pokładowym komputerze. W tej lokacji budujesz Treasure Reels, klon TikToka: pionowe klipy na cały ekran, przewijane kciukiem jeden po drugim, z dźwiękami, nagrywarką, duetami i edytorem. Zaczynasz od serca aplikacji, czyli feedu.

Czego się nauczysz

  • założyć projekt Treasure Reels i zlecić feed planem zbudowanym na zrzucie ekranu;
  • przeczytać w Cursorze kod, który decyduje, który klip gra, a który stoi;
  • sprawdzić zachowanie w przeglądarce, a nie tylko wygląd: przewinąć i posłuchać;
  • rozpoznać trzy błędy, które agent robi przy wideo najczęściej.

Nowy port: projekt treasure-reels

Treasure Reels to osobna aplikacja, więc zakładasz ją poleceniem z lekcji 1_2, zmieniając tylko nazwę. Zanim klikniesz Yes, porównaj komendę z tą:

npx create-next-app@latest treasure-reels --ts --eslint --tailwind --app --no-src-dir --no-cache-components --agents-md --no-agent-feedback --use-npm

Dalej znana pętla: sesja w folderze treasure-reels, CLAUDE.md z importem @AGENTS.md, Vitest z poprawką @types/node z lekcji 4_1 i pierwszy commit. Do feedu potrzebujesz jeszcze kilku krótkich klipów z dźwiękiem w public/videos/. Nagraj telefonem cztery pionowe ujęcia po kilka sekund albo, jeśli masz program ffmpeg, poproś Claude o cztery klipy testowe, każdy z innym tonem dźwięku. Inny ton w każdym klipie przyda się przy przeglądzie, bo usłyszysz, który klip gra.

Plan ze zrzutu ekranu

Feed łatwiej pokazać niż opisać. Zrób zrzut ekranu z dowolnej aplikacji z krótkimi klipami i zapisz go jako szkice/feed.png, tak jak szkice z lokacji 4. Potem zacznij od planu, bo przy wideo najwięcej błędów kryje się w tym, czego na zrzucie nie widać.

Polecenie dla Claude Code:

/plan Zbuduj w Treasure Reels pionowy feed jak na szkice/feed.png:
jeden klip na cały ekran, przewijanie kciukiem z przyciąganiem do
klipu, nakładka z autorem, opisem, hashtagami, dźwiękiem i licznikami.
Typy w types/video.ts, dane w lib/videos.ts z klipów w public/videos,
komponenty ForYouFeed i VideoInfoOverlay. Napisz w planie, co dzieje
się z klipem, który zjechał z ekranu, i co, gdy przeglądarka nie
pozwoli odtworzyć klipu z dźwiękiem. Nie pisz jeszcze kodu.

Dwa ostatnie pytania to haczyki. Dobry plan odpowiada: klip poza ekranem staje i wraca na początek, a feed startuje wyciszony i ma przycisk włączenia dźwięku. Plan, który o tym milczy, poprawiasz przed akceptacją, a nie po buildzie.

Co napisał Claude: typy

Otwórz w Cursorze types/video.ts. Dźwięk i klip mają po jednym typie, z którego korzysta cała aplikacja:

export interface Sound {
  id: string;
  title: string; // "Hymn piratów"
  author: string;
}

export interface Video {
  id: string;
  src: string; // "/videos/kapitan.mp4"
  poster: string; // pierwsza klatka jako obrazek
  author: { username: string; verified: boolean };
  caption: string;
  hashtags: string[];
  sound: Sound;
  likes: number;
  comments: number;
  shares: number;
}

poster to obrazek, który przeglądarka pokazuje, zanim klip się wczyta. sound nie jest napisem, tylko obiektem typu Sound, bo w następnej lekcji biblioteka dźwięków rozbuduje właśnie ten typ, zamiast pisać drugi, podobny. Dwa typy tego samego dźwięku po jakimś czasie zaczynają się różnić, a kompilator nie ma jak tego zauważyć.

Co napisał Claude: liczniki

Liczby na nakładce przechodzą przez jedną funkcję z lib/format.ts:

const compact = new Intl.NumberFormat("pl-PL", {
  notation: "compact",
  maximumFractionDigits: 1,
});

export function formatCount(count: number): string {
  return compact.format(count);
}

Intl.NumberFormat to wbudowany w przeglądarkę formater liczb, a notation: "compact" skraca duże wartości po polsku. U nas test pokazał 999 jako "999", 1500 jako "1,5 tys." i 2 340 000 jako "2,3 mln". Między liczbą a skrótem stoi spacja nierozdzielająca, więc test porównujący ze zwykłą spacją padnie mimo identycznie wyglądających napisów.

Co napisał Claude: który klip jest na ekranie

Otwórz components/ForYouFeed.tsx. Kontener ma klasy snap-y snap-mandatory overflow-y-scroll, a każdy slajd h-dvh snap-start: przewijanie zatrzymuje się zawsze na początku klipu. To, który klip zajmuje ekran, mówi obserwator przecięcia, czyli IntersectionObserver, wbudowany w przeglądarkę strażnik zgłaszający, gdy element pojawia się w widoku:

useEffect(() => {
  const observer = new IntersectionObserver(
    (entries) => {
      for (const entry of entries) {
        if (entry.isIntersecting) {
          setActive(Number((entry.target as HTMLElement).dataset.index));
        }
      }
    },
    { threshold: 0.6 },
  );
  slideRefs.current.forEach((slide) => slide && observer.observe(slide));
  return () => observer.disconnect();
}, [videos]);

threshold: 0.6 znaczy, że slajd liczy się jako aktywny, gdy widać co najmniej 60% jego wysokości. Numer slajdu siedzi w atrybucie data-index. Stan zmienia się w funkcji zwrotnej obserwatora, a nie wprost w ciele efektu, więc reguła lintera react-hooks/set-state-in-effect, która odrzuca stan ustawiany wprost w efekcie, nie ma tu nic do zarzucenia. disconnect() przy sprzątaniu odpina strażnika, gdy feed znika ze strony.

Co napisał Claude: gra tylko jeden

Gdy zmienia się aktywny klip, drugi efekt przechodzi po wszystkich elementach <video>:

useEffect(() => {
  videoRefs.current.forEach((video, i) => {
    if (!video) return;
    if (i === active) {
      video.play().then(
        () => setBlocked(false),
        () => setBlocked(true),
      );
    } else {
      video.pause();
      video.currentTime = 0;
    }
  });
}, [active]);

Aktywny klip dostaje play(), każdy inny pause() i powrót na początek. Według MDN play() zwraca obietnicę, a przeglądarka, która nie pozwala na odtwarzanie bez udziału użytkownika, odrzuca ją błędem NotAllowedError. MDN radzi, żeby interfejs nie zakładał, że odtwarzanie ruszyło. Dlatego drugi argument then ustawia blocked, a na klipie pojawia się przycisk "Dotknij, aby odtworzyć". Klipy startują z muted i playsInline: według przewodnika MDN o autoodtwarzaniu wyciszony dźwięk albo wcześniejsza interakcja ze stroną to warunki, przy których przeglądarki zwykle pozwalają grać. Przycisk "Włącz dźwięk" w rogu zdejmuje wyciszenie po kliknięciu, czyli po interakcji.

Co napisał Claude: referencje do klipów

Efekt potrzebuje dostępu do każdego elementu <video>, więc Claude trzyma je w tablicy w useRef, a każdy element sam się do niej wpisuje funkcją ref:

<video
  ref={(el) => {
    videoRefs.current[i] = el;
  }}

Nawiasy klamrowe nie są tu ozdobą. Krótszy zapis ref={(el) => (videoRefs.current[i] = el)} zwraca przypisaną wartość, a w React 19 funkcja ref może zwrócić tylko nic albo funkcję sprzątającą. U nas npx tsc --noEmit odrzucił krótszą wersję błędem TS2322 z linią Type 'HTMLVideoElement | null' is not assignable to type 'void | (() => VoidOrUndefinedOnly)', a npm run lint jej nie zauważył.

Co napisał Claude: nie wszystko naraz

Cztery klipy to nic, ale feed ze stoma klipami nie może ich pobierać wszystkich na starcie:

preload={Math.abs(i - active) <= 1 ? "auto" : "none"}

Atrybut preload mówi przeglądarce, co pobrać przed odtworzeniem: none nic, auto cały plik. MDN zastrzega, że to tylko podpowiedź, którą przeglądarka może zignorować. U nas na starcie przeglądarka pobrała tylko pierwszy i drugi klip, a trzeci dopiero po przewinięciu na drugi. Obrazki poster przyszły dla wszystkich czterech, bo są małe.

Przegląd kapitana

  1. Pauza poprzedniego klipu. Typowy błąd agenta to efekt z jedną linią videoRefs.current[active]?.play(). Taka wersja przeszła u nas lint, tsc i build, a po przewinięciu na trzeci klip grały dwa naraz: pierwszy dalej w tle i trzeci na ekranie. Szukasz w pliku (Cmd+F na Macu, Ctrl+F na Windowsie) słowa pause, a potem sprawdzasz uchem: przewiń trzy klipy i posłuchaj, czy słychać jeden ton.
  2. Obietnica z play(). Każde play() ma obsługę odrzucenia. Czy Twoja przeglądarka zablokuje dźwięk, zależy od jej zasad i Twojej historii na stronie, więc kod musi obsłużyć oba wyniki.
  3. Klucz z id. Slajdy mają key={video.id}, nie indeks z map. Gdy feed dostanie nowe klipy na górze, React z kluczem z indeksu użyłby starego <video> dla innego klipu.
  4. Liczniki przez formatCount. Wyszukaj w projekcie (Cmd+Shift+F) .likes} i .comments}: surowa liczba na ekranie to znak, że formater został pominięty.
  5. Dowód. Poproś o test z udawanym odtwarzaczem jak w lekcji 4_1: po zmianie aktywnego slajdu poprzedni klip dostaje pause(), a odrzucone play() pokazuje przycisk. U nas wersja z błędem z punktu 1 oblała oba testy. Potem npm run lint, npx tsc --noEmit i npm run build.

Następny krok

Jeśli przegląd coś znalazł, poprawka idzie jednym wąskim poleceniem, na przykład: "W @components/ForYouFeed.tsx klipy poza ekranem mają się zatrzymywać i wracać na początek. Nic poza tym nie zmieniaj. Potem testy i lint." Diff w panelu Source Control ma pokazać zmianę w jednym efekcie, nic więcej. Gdy wszystko gra, a raczej gra jedno naraz, poproś o commit, na przykład "Feed For You z nakładką".

W edytorze poniżej czeka feed w miniaturze, z udawanymi klipami, które liczą sekundy. Przewijaj, polub klip i włącz błąd agenta, żeby zobaczyć, ile klipów gra naraz.

Zapamiętaj: kapitan nie ocenia skrzyni po tym, jak lśni, tylko otwiera ją i sprawdza, co jest w środku, a feed sprawdza się uchem, nie okiem.

Kod do tej lekcji: App.jsx
// Feed For You w miniaturze: udawane klipy liczą sekundy zamiast grać
import { useEffect, useState } from 'react';

const clips = [
  { id: 'v1', author: 'kapitan_redbeard', caption: 'Skrzynia pod palmą', sound: 'Hymn piratów', likes: 125400, color: 'from-sky-900 to-blue-700' },
  { id: 'v2', author: 'czarna_mary', caption: 'Abordaż o świcie', sound: 'Werble bitewne', likes: 1500, color: 'from-red-900 to-orange-700' },
  { id: 'v3', author: 'lowca_map', caption: 'Mapa do Isla de Muerta', sound: 'Szanta o wyspie', likes: 2340000, color: 'from-emerald-900 to-teal-700' },
  { id: 'v4', author: 'majtek_tom', caption: 'Coś się rusza pod wodą', sound: 'Hymn piratów', likes: 999, color: 'from-purple-900 to-fuchsia-700' },
];

const compact = new Intl.NumberFormat('pl-PL', { notation: 'compact', maximumFractionDigits: 1 });
const formatCount = (n) => compact.format(n);

export default function App() {
  const [active, setActive] = useState(0);
  const [playing, setPlaying] = useState(() => new Set([0]));
  const [loaded, setLoaded] = useState(() => new Set([0, 1]));
  const [seconds, setSeconds] = useState({});
  const [liked, setLiked] = useState(() => new Set());
  const [agentBug, setAgentBug] = useState(false);
  const [autoplayBlocked, setAutoplayBlocked] = useState(false);
  const [blocked, setBlocked] = useState(false);
  const [muted, setMuted] = useState(true);

  // Zegar udawanych klipów: co sekundę dolicza czas każdemu, który gra.
  useEffect(() => {
    const id = setInterval(() => {
      setSeconds((prev) => {
        const next = { ...prev };
        playing.forEach((i) => { next[i] = (next[i] || 0) + 1; });
        return next;
      });
    }, 1000);
    return () => clearInterval(id);
  }, [playing]);

  function goTo(index) {
    if (index < 0 || index >= clips.length) return;
    setActive(index);
    setLoaded((prev) => new Set([...prev, index - 1, index, index + 1].filter((i) => i >= 0 && i < clips.length)));
    // play() odrzucone przez przeglądarkę (NotAllowedError)
    if (autoplayBlocked) {
      setBlocked(true);
      setPlaying((prev) => (agentBug ? prev : new Set()));
      return;
    }
    setBlocked(false);
    if (agentBug) {
      // błąd agenta: tylko play() dla nowego klipu, bez pause() dla starych
      setPlaying((prev) => new Set([...prev, index]));
    } else {
      setPlaying(new Set([index]));
      setSeconds((prev) => {
        const next = { ...prev };
        clips.forEach((_, i) => { if (i !== index) next[i] = 0; });
        return next;
      });
    }
  }

  function toggleLike(id) {
    setLiked((prev) => {
      const next = new Set(prev);
      if (next.has(id)) next.delete(id);
      else next.add(id);
      return next;
    });
  }

  const clip = clips[active];
  const likes = clip.likes + (liked.has(clip.id) ? 1 : 0);

  return (
    <div className="min-h-screen bg-gray-950 text-white p-4 flex flex-col md:flex-row gap-4">
      <div className={`relative mx-auto h-[480px] w-[270px] rounded-2xl bg-gradient-to-b ${clip.color} overflow-hidden`}>
        <p className="absolute top-3 left-3 rounded-full bg-black/50 px-3 py-1 text-xs">
          {playing.has(active) ? `▶ gra ${seconds[active] || 0} s` : '⏸ stoi'}
        </p>
        <button
          type="button"
          onClick={() => setMuted((m) => !m)}
          className="absolute top-3 right-3 rounded-full bg-black/50 px-3 py-1 text-xs"
        >
          {muted ? 'Włącz dźwięk' : 'Wycisz'}
        </button>
        {blocked && (
          <button
            type="button"
            onClick={() => { setBlocked(false); setPlaying((prev) => new Set([...prev, active])); }}
            className="absolute inset-0 m-auto h-12 w-48 rounded-full bg-black/70 text-sm"
          >
            Dotknij, aby odtworzyć
          </button>
        )}
        <div className="absolute right-3 bottom-24 flex flex-col items-center gap-1">
          <button type="button" aria-pressed={liked.has(clip.id)} onClick={() => toggleLike(clip.id)} className="text-3xl">
            <span className={liked.has(clip.id) ? 'text-red-500' : 'text-white'}>♥</span>
          </button>
          <span className="text-xs font-semibold">{formatCount(likes)}</span>
        </div>
        <div className="absolute bottom-4 left-3 right-14">
          <p className="font-bold">@{clip.author}</p>
          <p className="text-sm">{clip.caption}</p>
          <p className="mt-1 inline-block rounded-full bg-black/40 px-2 py-1 text-xs">♪ {clip.sound}</p>
        </div>
      </div>

      <div className="flex-1 space-y-3 text-sm">
        <div className="flex gap-2">
          <button type="button" onClick={() => goTo(active - 1)} disabled={active === 0} className="rounded bg-gray-700 px-4 py-2 disabled:opacity-40">▲ Poprzedni</button>
          <button type="button" onClick={() => goTo(active + 1)} disabled={active === clips.length - 1} className="rounded bg-gray-700 px-4 py-2 disabled:opacity-40">▼ Następny</button>
        </div>
        <p>Klip {active + 1} z {clips.length}. Grają teraz: <strong>{playing.size}</strong></p>
        <ul className="space-y-1">
          {clips.map((c, i) => (
            <li key={c.id} className={i === active ? 'text-yellow-300' : 'text-gray-300'}>
              {i + 1}. {c.caption}: {playing.has(i) ? `gra (${seconds[i] || 0} s)` : 'stoi'}, {loaded.has(i) ? 'pobrany' : 'czeka (preload none)'}
            </li>
          ))}
        </ul>
        <label className="flex items-center gap-2">
          <input type="checkbox" checked={agentBug} onChange={(e) => setAgentBug(e.target.checked)} />
          Błąd agenta: tylko play(), bez pause()
        </label>
        <label className="flex items-center gap-2">
          <input type="checkbox" checked={autoplayBlocked} onChange={(e) => setAutoplayBlocked(e.target.checked)} />
          Przeglądarka odrzuca play() (NotAllowedError)
        </label>
      </div>
    </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. Co ma się dziać w feedzie Treasure Reels z klipem, który zjechał z ekranu?

  2. 2. Po co w poleceniu planu feedu pytanie o klip poza ekranem i o zablokowany dźwięk?

To 2 z 7 pytań do tej lekcji. Pozostałe rozwiążesz w grze.

Zadania praktyczne w grze

  • Edytor kodu

    TikTok-style feed

  • Układanie w poziomie

    Ułóż linię, która każe pobierać tylko aktywny klip i jego sąsiadów:

  • Klikanie w kolejności

    Zbuduj instrukcję, która przewija zatrzymany klip na początek (klikaj po kolei):

  • Edytor kodu

    Video overlay component

  • Układanie w pionie

    Uporządkuj pracę nad feedem z lekcji (od pierwszego kroku):

  • Układanie w poziomie

    Ułóż linię, która oddaje strażnikowi wszystkie slajdy feedu:

  1. PytanieKlip poza ekranem
  2. PytanieHaczyki w poleceniu planu
  3. PytanieOdrzucone play()
  4. Zadanie z kodemPraktyka: Vertical video feed
  5. Ułóż w kolejnościAtrybut preload w feedzie
  6. PytanieKlamry w funkcji ref
  7. Kliknij w kolejnościPowrót klipu na początek
  8. PytanieIntersectionObserver w feedzie
  9. Zadanie z kodemPraktyka: Video info overlay
  10. Ułóż w kolejnościOd zrzutu do sprawdzianu uchem
  11. PytanieFunkcja formatCount
  12. PytaniePole poster w Video
  13. Ułóż w kolejnościObserwowanie slajdów

Przydatne artykuły