Kurs vibe coding z Claude Code · Moduł 11: Klon Spotify

Playlisty: najpierw dane, potem ekran

7 min czytania
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

  1. 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ła Hydration failed because the server rendered text didn't match the client: serwer narysował "11/15/2026", a przeglądarka "15.11.2026". Wyszukaj w components/ (Cmd+Shift+F) new Date(: każde trafienie w widoku to podejrzenie, że agent wymyślił dane.
  2. 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 w className, 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.
  3. Nieużywany stan. Linia const [sortBy, setSortBy] = useState("addedAt"), której nic nie czyta. U nas npm run lint wypisał tylko ostrzeżenie 'sortBy' is assigned a value but never used i zakończył się sukcesem. Czytaj ostrzeżenia, nie tylko błędy, i zapytaj Claude, czy to zapomniana funkcja, czy śmieć.
  4. 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. 1. Dlaczego addedAt jest w typie PlaylistTrack, a nie w typie Track?

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

  1. PytanieData dodania na playliście
  2. PytanieOstrzeżenie o nieużywanym stanie
  3. Kliknij w kolejnościWarunek przycisku Utwórz
  4. Kliknij w kolejnościTyp zdarzenia wysłania formularza
  5. Ułóż w kolejnościKomórka Dodano z danych
  6. Ułóż w kolejnościFormater daty dodania
  7. Zadanie z kodemPraktyka: Playlist page
  8. PytanieLibrary: identyfikatory zamiast kopii
  9. Kliknij w kolejnościZbuduj sumowanie czasu playlisty
  10. Ułóż w kolejnościPlaylisty w trzech krokach
  11. PytanieDwie klasy hover na jednym wierszu
  12. Ułóż w kolejnościGdy sortowanie pójdzie źle
  13. PytanieStrefa czasowa daty dodania
  14. PytanieData-atrapa w kolumnie Dodano
  15. Ułóż w kolejnościDostęp do nazwy właściciela
  16. Ułóż w kolejnościUtworzenie playlisty krok po kroku
  17. Zadanie z kodemPraktyka: Create playlist modal
  18. PytanieNazwa z samych spacji

Przydatne artykuły