Kurs vibe coding z Claude Code · Moduł 11: Klon Spotify
Playlisty: najpierw dane, potem ekran
W tej lekcji9
Odtwarzacz gra ale załoga chce więcej niż jedną kolejkę. Bosman zbiera szanty do wciągania lin, kucharz ballady na wieczór, a kapitan chce widzieć przy każdym utworze, kiedy trafił na listę. To playlisty. Ekran playlisty łatwo zamówić jednym poleceniem, a agent, który dostaje ekran przed danymi, chętnie te dane wymyśla. Typowy wynik to kolumna "Dodano", w której każdy utwór ma tę samą, dzisiejszą datę.
Czego się nauczysz
- zamówić funkcję w trzech krokach: dane, ekran, formularz;
- sprawdzić, czy każda kolumna czyta prawdziwe pole z danych;
- wyłapać martwe klasy i nieużywany stan, które lint przepuszcza;
- wrócić przez
/rewind, gdy krok poszedł w złą stronę.
Krok 1: dane
Ekran pokazuje dane, więc dane powstają pierwsze. Jedno polecenie "zrób playlisty" dałoby kilkaset linii w kilku plikach naraz, a pole, którego brakuje w typie, agent załatałby w widoku czymkolwiek, co wygląda wiarygodnie. Trzy małe kroki dają trzy diffy, z których każdy przeczytasz w kilka minut, i trzy commity, do których możesz wrócić. Ten krok nie dotyka żadnego komponentu i kończy się kryterium ukończenia, tak jak w lekcji 10_1.
Polecenie dla Claude Code (krok 1):
Krok 1 z 3. W types/music.ts typy Playlist, PlaylistTrack i Library.
Utwór na playliście pamięta datę dodania (addedAt, napis ISO w UTC),
Library trzyma identyfikatory, nie kopie obiektów. Przykładową
playlistę dopisz do lib/catalog.ts, obok utworów. W lib/playlist.ts
funkcje totalDuration i formatAddedAt z testami. Żadnych komponentów.
Będzie gotowe, gdy: totalDuration przykładowej playlisty to suma
długości jej utworów, formatAddedAt("2026-11-14T23:40:00Z") zwraca
"15 lis 2026", a testy i npm run lint przechodzą.Co napisał Claude: utwór z datą dodania
Otwórz w Cursorze types/music.ts. Data dodania nie należy do utworu, tylko do jego miejsca na playliście, bo ta sama szanta może trafić na dwie listy w różne dni:
export interface PlaylistTrack {
track: Track;
addedAt: string; // "2026-11-02T18:30:00Z", data dodania w UTC
}addedAt to napis w formacie ISO, czyli data z godziną zapisana tak, jak przesyła ją każdy serwer. Litera Z na końcu znaczy czas UTC, bez strefy czasowej użytkownika. Sama playlista wygląda tak:
export interface Playlist {
id: string;
name: string;
description: string;
isPublic: boolean;
isCollaborative: boolean;
owner: { id: string; username: string };
tracks: PlaylistTrack[];
}isPublic mówi, czy listę widzi cała załoga, a isCollaborative, czy utwory mogą do niej dodawać także inni piraci, nie tylko właściciel. Biblioteka użytkownika ma pola likedTrackIds i followedArtistIds, czyli identyfikatory polubionych utworów i obserwowanych artystów. Identyfikator nigdy się nie zestarzeje, a kopia obiektu artysty zostałaby ze starą nazwą, gdy artysta ją zmieni.
Co napisał Claude: suma i data
W lib/playlist.ts stoją dwie małe funkcje. Pierwsza sumuje długości utworów:
export function totalDuration(playlist: Playlist): number {
return playlist.tracks.reduce((sum, item) => sum + item.track.duration, 0);
}reduce przechodzi po liście i dokłada każdą długość do sumy, która startuje od zera. Wynik idzie przez formatTime z lekcji 10_1, nie przez nowy formater. Druga funkcja zamienia datę na tekst:
const addedAtFormat = new Intl.DateTimeFormat("pl-PL", {
day: "numeric",
month: "short",
year: "numeric",
timeZone: "Europe/Warsaw",
});timeZone to strefa czasowa ustawiona na sztywno. Bez niej serwer i przeglądarka mogą pokazać inny dzień, jeśli stoją w różnych strefach. U nas test pokazał to wyraźnie: utwór dodany 14 listopada o 23:40 UTC to w Warszawie już "15 lis 2026".
Krok 2: ekran playlisty
Commit po kroku 1, i dopiero wtedy ekran.
Polecenie dla Claude Code (krok 2):
Krok 2 z 3. components/PlaylistPage.tsx i strona /playlisty/[id]:
nagłówek z gradientem, nazwą, opisem, właścicielem, liczbą utworów
i łącznym czasem, przycisk Graj, tabela z kolumnami #, Tytuł, Album,
Dodano, Czas. Każda kolumna czyta pole z danych z kroku 1. Podwójne
kliknięcie wiersza odtwarza ten utwór w MusicPlayer z lekcji 10_1.
Tailwind 4. Na koniec lint, typy, testy i build.Co napisał Claude: nagłówek i wiersz
Otwórz components/PlaylistPage.tsx. Nagłówek ma tło przechodzące od bursztynu do szarości:
<header className="rounded-t-xl bg-linear-to-b from-amber-700 to-gray-900 p-6">bg-linear-to-b to nazwa z dokumentacji Tailwinda 4: gradient liniowy z góry na dół. W starszych poradnikach i w kodzie wielu agentów zobaczysz bg-gradient-to-b. Według naszego researchu stara nazwa nadal działa w Tailwindzie 4, ale nie ma jej już w dokumentacji, więc trzymasz się nowej. Wiersz tabeli wygląda tak:
<div
key={item.track.id}
role="row"
onDoubleClick={() => onPlay(i)}
className="grid grid-cols-[2rem_1fr_1fr_8rem_4rem] gap-2 rounded py-2 hover:bg-white/10"
>grid-cols-[...] to pięć kolumn o podanych szerokościach, tych samych w nagłówku tabeli i w każdym wierszu. hover:bg-white/10 rozjaśnia wiersz pod kursorem białym kolorem z przezroczystością 10%. Każda komórka to <span role="cell">, a role="row" i role="cell" mówią czytnikom ekranu, że ta siatka z elementów div to tabela. Komórka "Dodano" to <span role="cell">{formatAddedAt(item.addedAt)}</span>, a "Czas" pokazuje {formatTime(item.track.duration)}. Podwójne kliknięcie woła onPlay z numerem wiersza. Strona playlisty pokazuje wtedy odtwarzacz z lekcji 10_1 z kluczem key={start} i utworami tej playlisty, a nowy klucz daje świeży odtwarzacz od wybranego utworu. Podwójne kliknięcie to skrót dla myszy. Z klawiatury playlistę uruchamia przycisk Graj w nagłówku, który jest wyłączony, gdy lista nie ma utworów. Wybór konkretnego wiersza klawiaturą to osobne, małe polecenie na później, a nie coś, co agent powinien dorzucić bez pytania.
Krok 3: formularz nowej playlisty
Polecenie dla Claude Code (krok 3):
Krok 3 z 3. components/CreatePlaylistModal.tsx otwierany przyciskiem
"Nowa playlista" na stronie /playlisty: nazwa (wymagana), opis,
pole "Publiczna". Przycisk Utwórz wyłączony, dopóki nazwa jest pusta
albo ma same spacje. onCreate dostaje przycięte wartości.Otwórz components/CreatePlaylistModal.tsx. Warunek przycisku liczy się w trakcie rysowania, bez osobnego stanu:
const canCreate = name.trim() !== "";
function handleSubmit(event: React.SubmitEvent<HTMLFormElement>) {
event.preventDefault();
if (!canCreate) return;
onCreate({ name: name.trim(), description: description.trim(), isPublic });
}trim() obcina spacje z początku i końca, więc trzy spacje to pusta nazwa. Przycisk ma disabled={!canCreate}, a wyłączony przycisk wysyłania blokuje też Enter w polu. U nas trzy spacje i Enter nie zrobiły nic, a nazwa wpisana jako " Ballady nocne" trafiła na listę jako "Ballady nocne". React.SubmitEvent to typ zdarzenia wysłania formularza, który zalecają obecne typy Reacta.
Przegląd kapitana
- Dane-atrapa. Typowy błąd agenta to komórka
{new Date().toLocaleDateString()}w kolumnie "Dodano". U nas wszystkie trzy wiersze pokazały "15.11.2026", a konsola w trybie deweloperskim zgłosiłaHydration failed because the server rendered text didn't match the client: serwer narysował "11/15/2026", a przeglądarka "15.11.2026". Wyszukaj wcomponents/(Cmd+Shift+F)new Date(: każde trafienie w widoku to podejrzenie, że agent wymyślił dane. - Sprzeczne klasy. Agent potrafi napisać
hover:bg-white hover:bg-white/10, czyli dwa kolory tła dla tej samej sytuacji. U nas wygrało/10, niezależnie od kolejności wclassName, bo kolejność reguł ustala Tailwind w wygenerowanym CSS. Druga klasa to martwy ładunek, który myli następnego czytelnika: zostaw tylko tę, którą chcesz. - Nieużywany stan. Linia
const [sortBy, setSortBy] = useState("addedAt"), której nic nie czyta. U nasnpm run lintwypisał tylko ostrzeżenie'sortBy' is assigned a value but never usedi zakończył się sukcesem. Czytaj ostrzeżenia, nie tylko błędy, i zapytaj Claude, czy to zapomniana funkcja, czy śmieć. - Każda kolumna z danych. Porównaj nagłówki tabeli z komórkami wiersza: pięć nagłówków, pięć komórek, każda z polem z
PlaylistTrack.
Następny krok
Załoga chce sortować listę po tytule i po dacie dodania. To osobne, wąskie polecenie: "W @components/PlaylistPage.tsx dodaj sortowanie po tytule i po dacie dodania. Sortuj kopię listy. Nic poza tym nie zmieniaj." Jeśli diff pokaże zmiany w plikach, o które nie prosiłeś, albo sortowanie wywróci kolejność odtwarzania, nie łataj tego trzecim poleceniem. Wpisz /rewind z lekcji 0_6, wybierz polecenie z sortowaniem i przywróć kod. Pamiętaj o granicy: /rewind cofa zmiany zrobione narzędziami Claude do edycji plików, a nie skutki komend terminala. Potem wydaj mniejsze polecenie. Każdy z trzech kroków kończy się osobnym commitem.
W edytorze poniżej czeka playlista z tabelą i formularzem. Włącz błąd agenta z datą i zobacz, jak wszystkie wiersze dostają ten sam dzień, a potem spróbuj utworzyć playlistę z samych spacji.
Zapamiętaj: szafa z szantami ma być uporządkowana, a nie tylko ładna, a każda kolumna na ekranie musi mieć swoje pole w ładowni danych.
Kod do tej lekcji: App.jsx
// Playlista w miniaturze: każda kolumna czyta pole z danych
import { useState } from 'react';
const playlist = {
name: 'Szanty na wachtę',
description: 'Do śpiewania przy linach',
isPublic: true,
owner: { username: 'redbeard' },
tracks: [
{ track: { id: 't1', title: 'Hymn piratów', artist: 'Kapitan Redbeard', album: 'Pieśni z pokładu', duration: 125 }, addedAt: '2026-10-30T21:15:00Z' },
{ track: { id: 't3', title: 'Szanta o wyspie', artist: 'Kapitan Redbeard', album: 'Pieśni z pokładu', duration: 150 }, addedAt: '2026-11-02T08:05:00Z' },
{ track: { id: 't4', title: 'Pieśń krakena', artist: 'Czarna Mary', album: 'Burza nad Tortugą', duration: 70 }, addedAt: '2026-11-14T23:40:00Z' },
],
};
function formatTime(seconds) {
if (!Number.isFinite(seconds) || seconds < 0) return '0:00';
const whole = Math.floor(seconds);
return `${Math.floor(whole / 60)}:${String(whole % 60).padStart(2, '0')}`;
}
const addedAtFormat = new Intl.DateTimeFormat('pl-PL', { day: 'numeric', month: 'short', year: 'numeric', timeZone: 'Europe/Warsaw' });
const formatAddedAt = (iso) => addedAtFormat.format(new Date(iso));
const totalDuration = (p) => p.tracks.reduce((sum, item) => sum + item.track.duration, 0);
const COLUMNS = 'grid grid-cols-[2rem_1fr_1fr_7rem_3rem] gap-2';
function CreatePlaylistModal({ onCreate, onClose, agentBug }) {
const [name, setName] = useState('');
const [description, setDescription] = useState('');
const [isPublic, setIsPublic] = useState(true);
const canCreate = agentBug ? true : name.trim() !== '';
function handleSubmit(event) {
event.preventDefault();
if (!canCreate) return;
onCreate({ name: agentBug ? name : name.trim(), description: description.trim(), isPublic });
}
return (
<div className="fixed inset-0 flex items-center justify-center bg-black/70">
<form role="dialog" aria-modal="true" onSubmit={handleSubmit} className="w-80 space-y-3 rounded-xl bg-gray-800 p-5">
<h2 className="text-xl font-bold">Nowa playlista</h2>
<label className="block">Nazwa
<input value={name} onChange={(e) => setName(e.target.value)} autoFocus className="mt-1 w-full rounded bg-gray-700 p-2" />
</label>
<label className="block">Opis
<textarea value={description} onChange={(e) => setDescription(e.target.value)} className="mt-1 w-full rounded bg-gray-700 p-2" />
</label>
<label className="flex items-center gap-2">
<input type="checkbox" checked={isPublic} onChange={(e) => setIsPublic(e.target.checked)} /> Publiczna
</label>
<div className="flex justify-end gap-2">
<button type="button" onClick={onClose} className="px-3 py-2">Anuluj</button>
<button type="submit" disabled={!canCreate} className="rounded-full bg-green-500 px-4 py-2 font-semibold text-black disabled:opacity-40">Utwórz</button>
</div>
</form>
</div>
);
}
export default function App() {
const [nowPlaying, setNowPlaying] = useState(null);
const [dateBug, setDateBug] = useState(false);
const [hoverBug, setHoverBug] = useState(false);
const [buttonBug, setButtonBug] = useState(false);
const [open, setOpen] = useState(false);
const [created, setCreated] = useState([]);
const rowHover = hoverBug ? 'hover:bg-white hover:bg-white/10' : 'hover:bg-white/10';
return (
<div className="min-h-screen bg-gray-950 p-4 text-white">
<div className="mx-auto max-w-2xl">
<header className="rounded-t-xl bg-linear-to-b from-amber-700 to-gray-900 p-5">
<p className="text-xs uppercase">{playlist.isPublic ? 'Playlista publiczna' : 'Playlista prywatna'}</p>
<h1 className="text-3xl font-bold">{playlist.name}</h1>
<p className="text-gray-200">{playlist.description}</p>
<p className="mt-1 text-sm">{playlist.owner.username} · {playlist.tracks.length} utw. · {formatTime(totalDuration(playlist))}</p>
<button type="button" onClick={() => setNowPlaying(playlist.tracks[0].track.title)} className="mt-3 rounded-full bg-green-500 px-5 py-2 font-semibold text-black">Graj</button>
</header>
<div className="bg-gray-900 p-3 text-sm">
<div className={`${COLUMNS} border-b border-gray-700 pb-2 text-gray-400`}>
<span>#</span><span>Tytuł</span><span>Album</span><span>Dodano</span><span>Czas</span>
</div>
{playlist.tracks.map((item, i) => (
<div key={item.track.id} onDoubleClick={() => setNowPlaying(item.track.title)} className={`${COLUMNS} rounded py-2 ${rowHover}`}>
<span>{i + 1}</span>
<span>{item.track.title}<br /><span className="text-gray-400">{item.track.artist}</span></span>
<span>{item.track.album}</span>
<span>{dateBug ? new Date().toLocaleDateString() : formatAddedAt(item.addedAt)}</span>
<span>{formatTime(item.track.duration)}</span>
</div>
))}
</div>
<p className="mt-2 text-sm text-gray-300">{nowPlaying ? `Teraz gra: ${nowPlaying}` : 'Kliknij dwa razy wiersz, żeby go odtworzyć.'}</p>
<div className="mt-4 space-y-1 text-sm">
<label className="flex items-center gap-2"><input type="checkbox" checked={dateBug} onChange={(e) => setDateBug(e.target.checked)} /> Błąd agenta: Dodano z new Date()</label>
<label className="flex items-center gap-2"><input type="checkbox" checked={hoverBug} onChange={(e) => setHoverBug(e.target.checked)} /> Błąd agenta: dwie klasy hover</label>
<label className="flex items-center gap-2"><input type="checkbox" checked={buttonBug} onChange={(e) => setButtonBug(e.target.checked)} /> Błąd agenta: Utwórz zawsze aktywny</label>
<p className="font-mono text-xs text-gray-400">Klasy wiersza: {rowHover}</p>
</div>
<div className="mt-4">
<button type="button" onClick={() => setOpen(true)} className="rounded-full bg-white px-4 py-2 font-semibold text-black">Nowa playlista</button>
<ul className="mt-2 text-sm">
{created.map((p, i) => (
<li key={i}>„{p.name}” {p.isPublic ? '(publiczna)' : '(prywatna)'}{p.name.trim() === '' && <strong className="text-red-400"> playlista bez nazwy!</strong>}</li>
))}
</ul>
</div>
{open && (
<CreatePlaylistModal
agentBug={buttonBug}
onClose={() => setOpen(false)}
onCreate={(p) => { setCreated((list) => [...list, p]); setOpen(false); }}
/>
)}
</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. Dlaczego addedAt jest w typie PlaylistTrack, a nie w typie Track?
2. npm run lint kończy się sukcesem, ale wypisuje ostrzeżenie: 'sortBy' is assigned a value but never used. Co robisz?
To 2 z 7 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Klikanie w kolejności
Kliknij elementy, aby zbudować warunek, od którego zależy przycisk Utwórz:
- Klikanie w kolejności
Kliknij elementy, aby zbudować nagłówek funkcji obsługującej wysłanie formularza:
- Układanie w poziomie
Ułóż w jednej linii komórkę kolumny Dodano:
- Układanie w poziomie
Ułóż w jednej linii początek formatera daty dodania:
- Edytor kodu
Playlist display component
- Klikanie w kolejności
Kliknij elementy, aby zsumować czas trwania utworów:
- Układanie w pionie
Uporządkuj kroki budowy playlist z lekcji:
- Układanie w pionie
Uporządkuj kroki, gdy polecenie z sortowaniem playlisty zmieniło za dużo:
- Układanie w poziomie
Ułóż tokeny odczytu nazwy właściciela playlisty w jednej linii:
- Układanie w pionie
Uporządkuj, co dzieje się po kliknięciu Utwórz z poprawną nazwą:
- Edytor kodu
Playlist creation interface
Zadania po tej lekcji
- PytanieData dodania na playliście
- PytanieOstrzeżenie o nieużywanym stanie
- Kliknij w kolejnościWarunek przycisku Utwórz
- Kliknij w kolejnościTyp zdarzenia wysłania formularza
- Ułóż w kolejnościKomórka Dodano z danych
- Ułóż w kolejnościFormater daty dodania
- Zadanie z kodemPraktyka: Playlist page
- PytanieLibrary: identyfikatory zamiast kopii
- Kliknij w kolejnościZbuduj sumowanie czasu playlisty
- Ułóż w kolejnościPlaylisty w trzech krokach
- PytanieDwie klasy hover na jednym wierszu
- Ułóż w kolejnościGdy sortowanie pójdzie źle
- PytanieStrefa czasowa daty dodania
- PytanieData-atrapa w kolumnie Dodano
- Ułóż w kolejnościDostęp do nazwy właściciela
- Ułóż w kolejnościUtworzenie playlisty krok po kroku
- Zadanie z kodemPraktyka: Create playlist modal
- PytanieNazwa z samych spacji