Kurs vibe coding z Claude Code · Moduł 10: Klon TikToka
Feed For You: jeden klip na ekran, sprawdzany uchem
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-npmDalej 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
- Pauza poprzedniego klipu. Typowy błąd agenta to efekt z jedną linią
videoRefs.current[active]?.play(). Taka wersja przeszła u nas lint,tsci 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łowapause, a potem sprawdzasz uchem: przewiń trzy klipy i posłuchaj, czy słychać jeden ton. - 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. - Klucz z id. Slajdy mają
key={video.id}, nie indeks zmap. Gdy feed dostanie nowe klipy na górze, React z kluczem z indeksu użyłby starego<video>dla innego klipu. - Liczniki przez formatCount. Wyszukaj w projekcie (Cmd+Shift+F)
.likes}i.comments}: surowa liczba na ekranie to znak, że formater został pominięty. - Dowód. Poproś o test z udawanym odtwarzaczem jak w lekcji 4_1: po zmianie aktywnego slajdu poprzedni klip dostaje
pause(), a odrzuconeplay()pokazuje przycisk. U nas wersja z błędem z punktu 1 oblała oba testy. Potemnpm run lint,npx tsc --noEmitinpm 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. Co ma się dziać w feedzie Treasure Reels z klipem, który zjechał z ekranu?
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:
Zadania po tej lekcji
- PytanieKlip poza ekranem
- PytanieHaczyki w poleceniu planu
- PytanieOdrzucone play()
- Zadanie z kodemPraktyka: Vertical video feed
- Ułóż w kolejnościAtrybut preload w feedzie
- PytanieKlamry w funkcji ref
- Kliknij w kolejnościPowrót klipu na początek
- PytanieIntersectionObserver w feedzie
- Zadanie z kodemPraktyka: Video info overlay
- Ułóż w kolejnościOd zrzutu do sprawdzianu uchem
- PytanieFunkcja formatCount
- PytaniePole poster w Video
- Ułóż w kolejnościObserwowanie slajdów