Cours Vibe coding avec Claude Code · Module 11: Clone de Spotify
Playlists : d'abord les données, ensuite l'écran
Dans cette leçon9
Le lecteur joue mais l'équipage veut plus qu'une seule file. Le maître d'équipage rassemble les shanties pour hisser les cordages, le cuisinier les ballades du soir, et le capitaine veut voir, devant chaque morceau, quand il a été ajouté à la liste. Ce sont les playlists. L'écran d'une playlist se commande facilement en une seule demande, mais un agent à qui l'on donne l'écran avant les données invente volontiers ces données. Résultat typique : une colonne "Ajouté" où chaque morceau porte la même date, celle d'aujourd'hui.
Ce que tu vas apprendre
- commander une fonctionnalité en trois étapes : les données, l'écran, le formulaire ;
- vérifier que chaque colonne lit un vrai champ des données ;
- repérer les classes mortes et l'état inutilisé que le lint laisse passer ;
- revenir en arrière avec
/rewindquand une étape part dans la mauvaise direction.
Étape 1 : les données
L'écran affiche des données, donc les données naissent en premier. Une seule demande "fais les playlists" donnerait plusieurs centaines de lignes dans plusieurs fichiers à la fois, et pour un champ absent du type, l'agent boucherait le trou dans la vue avec ce qui a l'air crédible. Trois petites étapes donnent trois diffs que tu lis chacun en quelques minutes, et trois commits auxquels tu peux revenir. Cette étape ne touche aucun composant et se termine par un critère de fin, comme dans la leçon 10_1.
Demande pour Claude Code (étape 1) :
Étape 1 sur 3. Dans types/music.ts, les types Playlist, PlaylistTrack
et Library. Un morceau d'une playlist retient sa date d'ajout (addedAt,
texte ISO en UTC), Library garde des identifiants, pas des copies
d'objets. Ajoute une playlist d'exemple dans lib/catalog.ts, à côté
des morceaux. Dans lib/playlist.ts, les fonctions totalDuration et
formatAddedAt avec leurs tests. Aucun composant.
Ce sera fini quand : totalDuration de la playlist d'exemple vaut la
somme des durées de ses morceaux, formatAddedAt("2026-11-14T23:40:00Z")
renvoie "15 nov. 2026", et les tests et npm run lint passent.Ce que Claude a écrit : un morceau avec sa date d'ajout
Ouvre types/music.ts dans Cursor. La date d'ajout n'appartient pas au morceau, mais à sa place dans la playlist, car le même shanty peut atterrir sur deux listes à des jours différents :
export interface PlaylistTrack {
track: Track;
addedAt: string; // "2026-11-02T18:30:00Z", date d'ajout en UTC
}addedAt est un texte au format ISO, c'est-à-dire une date avec l'heure écrite comme tout serveur l'envoie. La lettre Z à la fin signifie l'heure UTC, sans le fuseau horaire de l'utilisateur. La playlist elle-même ressemble à ceci :
export interface Playlist {
id: string;
name: string;
description: string;
isPublic: boolean;
isCollaborative: boolean;
owner: { id: string; username: string };
tracks: PlaylistTrack[];
}isPublic dit si toute l'équipe voit la liste, et isCollaborative si d'autres pirates, et pas seulement le propriétaire, peuvent y ajouter des morceaux. La bibliothèque de l'utilisateur a les champs likedTrackIds et followedArtistIds, c'est-à-dire les identifiants des morceaux aimés et des artistes suivis. Un identifiant ne vieillit jamais, alors qu'une copie de l'objet artiste garderait l'ancien nom quand l'artiste le change.
Ce que Claude a écrit : la somme et la date
Dans lib/playlist.ts se trouvent deux petites fonctions. La première additionne les durées des morceaux :
export function totalDuration(playlist: Playlist): number {
return playlist.tracks.reduce((sum, item) => sum + item.track.duration, 0);
}reduce parcourt la liste et ajoute chaque durée à une somme qui démarre à zéro. Le résultat passe par formatTime de la leçon 10_1, pas par un nouveau formateur. La seconde fonction transforme la date en texte :
const addedAtFormat = new Intl.DateTimeFormat("fr-FR", {
day: "numeric",
month: "short",
year: "numeric",
timeZone: "Europe/Paris",
});timeZone est un fuseau horaire fixé en dur. Sans lui, le serveur et le navigateur peuvent afficher un jour différent s'ils sont dans des fuseaux différents. Chez nous, le test l'a montré clairement : un morceau ajouté le 14 novembre à 23:40 UTC est déjà le "15 nov. 2026" à Paris.
Étape 2 : l'écran de la playlist
Commit après l'étape 1, et seulement ensuite l'écran.
Demande pour Claude Code (étape 2) :
Étape 2 sur 3. components/PlaylistPage.tsx et la page /playlists/[id] :
en-tête avec un dégradé, le nom, la description, le propriétaire, le
nombre de morceaux et la durée totale, un bouton Lecture, un tableau
avec les colonnes #, Titre, Album, Ajouté, Durée. Chaque colonne lit
un champ des données de l'étape 1. Un double-clic sur une ligne joue
ce morceau dans MusicPlayer de la leçon 10_1. Tailwind 4. À la fin,
lint, types, tests et build.Ce que Claude a écrit : l'en-tête et la ligne
Ouvre components/PlaylistPage.tsx. L'en-tête a un fond qui passe de l'ambre au gris :
<header className="rounded-t-xl bg-linear-to-b from-amber-700 to-gray-900 p-6">bg-linear-to-b est le nom de la documentation de Tailwind 4 : un dégradé linéaire de haut en bas. Dans les anciens tutoriels et dans le code de nombreux agents, tu verras bg-gradient-to-b. D'après notre recherche, l'ancien nom fonctionne encore dans Tailwind 4 mais a disparu de la documentation, donc tu t'en tiens au nouveau. Une ligne du tableau ressemble à ceci :
<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-[...] fait cinq colonnes aux largeurs données, les mêmes dans l'en-tête du tableau et dans chaque ligne. hover:bg-white/10 éclaircit la ligne sous le curseur avec du blanc à 10 % d'opacité. Chaque cellule est un <span role="cell">, et role="row" et role="cell" disent aux lecteurs d'écran que cette grille d'éléments div est un tableau. La cellule "Ajouté" est <span role="cell">{formatAddedAt(item.addedAt)}</span>, et "Durée" affiche {formatTime(item.track.duration)}. Le double-clic appelle onPlay avec le numéro de la ligne. La page de la playlist montre alors le lecteur de la leçon 10_1, avec key={start} et les morceaux de cette playlist, et une nouvelle clé donne un lecteur tout neuf à partir du morceau choisi. Le double-clic est un raccourci pour la souris. Au clavier, la playlist se lance avec le bouton Lecture de l'en-tête, désactivé quand la liste n'a aucun morceau. Choisir une ligne précise au clavier est une petite demande à part, pour plus tard, et pas quelque chose que l'agent doit ajouter sans qu'on le lui demande.
Étape 3 : le formulaire d'une nouvelle playlist
Demande pour Claude Code (étape 3) :
Étape 3 sur 3. components/CreatePlaylistModal.tsx, ouvert par le bouton
"Nouvelle playlist" de la page /playlists : un nom (obligatoire), une
description, la case "Publique". Le bouton Créer est désactivé tant que
le nom est vide ou ne contient que des espaces. onCreate reçoit les
valeurs sans les espaces autour.Ouvre components/CreatePlaylistModal.tsx. La condition du bouton se calcule pendant le rendu, sans état séparé :
const canCreate = name.trim() !== "";
function handleSubmit(event: React.SubmitEvent<HTMLFormElement>) {
event.preventDefault();
if (!canCreate) return;
onCreate({ name: name.trim(), description: description.trim(), isPublic });
}trim() coupe les espaces au début et à la fin, donc trois espaces donnent un nom vide. Le bouton a disabled={!canCreate}, et un bouton d'envoi désactivé bloque aussi la touche Entrée dans le champ. Chez nous, trois espaces et Entrée n'ont rien fait, et un nom saisi comme " Ballades de nuit" est arrivé dans la liste sous la forme "Ballades de nuit". React.SubmitEvent est le type de l'événement d'envoi d'un formulaire que recommandent les types actuels de React.
La revue du capitaine
- Des données bouche-trou. L'erreur typique de l'agent est une cellule
{new Date().toLocaleDateString()}dans la colonne "Ajouté". Chez nous, les trois lignes ont affiché "15/11/2026", et la console en mode développement a signaléHydration failed because the server rendered text didn't match the client: le serveur avait dessiné "11/15/2026" et le navigateur "15/11/2026". Cherche danscomponents/(Cmd+Shift+F)new Date(: chaque occurrence dans une vue laisse soupçonner que l'agent a inventé des données. - Des classes contradictoires. Un agent peut écrire
hover:bg-white hover:bg-white/10, c'est-à-dire deux couleurs de fond pour la même situation. Chez nous, c'est/10qui l'a emporté, quel que soit l'ordre dansclassName, car l'ordre des règles est fixé par Tailwind dans le CSS généré. La seconde classe est une charge morte qui trompe le prochain lecteur : ne garde que celle que tu veux. - Un état inutilisé. Une ligne
const [sortBy, setSortBy] = useState("addedAt")que rien ne lit. Chez nous,npm run linta seulement affiché l'avertissement'sortBy' is assigned a value but never usedet s'est terminé avec succès. Lis les avertissements, pas seulement les erreurs, et demande à Claude si c'est une fonctionnalité oubliée ou un déchet. - Chaque colonne tirée des données. Compare les en-têtes du tableau avec les cellules d'une ligne : cinq en-têtes, cinq cellules, chacune avec un champ de
PlaylistTrack.
Étape suivante
L'équipage veut trier la liste par titre et par date d'ajout. C'est une demande à part, étroite : "Dans @components/PlaylistPage.tsx, ajoute le tri par titre et par date d'ajout. Trie une copie de la liste. Ne change rien d'autre." Si le diff montre des changements dans des fichiers que tu n'as pas demandés, ou si le tri bouscule l'ordre de lecture, ne rafistole pas avec une troisième demande. Tape /rewind (leçon 0_6), choisis la demande avec le tri et restaure le code. Garde la limite en tête : /rewind annule les changements faits par les outils d'édition de fichiers de Claude, pas les effets des commandes du terminal. Puis formule une demande plus petite. Chacune des trois étapes se termine par son propre commit.
Dans l'éditeur ci-dessous t'attend une playlist avec un tableau et un formulaire. Active l'erreur de l'agent sur la date et vois toutes les lignes recevoir le même jour, puis essaie de créer une playlist avec seulement des espaces.
À retenir : l'armoire à shanties doit être rangée, pas seulement jolie, et chaque colonne de l'écran doit avoir son champ dans la cale des données.
Code de cette leçon : App.jsx
// Playlist en miniature : chaque colonne lit un champ des données
import { useState } from 'react';
const playlist = {
name: 'Shanties de quart',
description: 'À chanter en tirant sur les cordages',
isPublic: true,
owner: { username: 'redbeard' },
tracks: [
{ track: { id: 't1', title: 'Hymne des pirates', artist: 'Capitaine Redbeard', album: 'Chants du pont', duration: 125 }, addedAt: '2026-10-30T21:15:00Z' },
{ track: { id: 't3', title: "Shanty de l'île", artist: 'Capitaine Redbeard', album: 'Chants du pont', duration: 150 }, addedAt: '2026-11-02T08:05:00Z' },
{ track: { id: 't4', title: 'Chant du kraken', artist: 'Mary la Noire', album: 'Tempête sur la Tortue', 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('fr-FR', { day: 'numeric', month: 'short', year: 'numeric', timeZone: 'Europe/Paris' });
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">Nouvelle playlist</h2>
<label className="block">Nom
<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">Description
<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)} /> Publique
</label>
<div className="flex justify-end gap-2">
<button type="button" onClick={onClose} className="px-3 py-2">Annuler</button>
<button type="submit" disabled={!canCreate} className="rounded-full bg-green-500 px-4 py-2 font-semibold text-black disabled:opacity-40">Créer</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 ? 'Playlist publique' : 'Playlist privée'}</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} morceaux · {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">Lecture</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>Titre</span><span>Album</span><span>Ajouté</span><span>Durée</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 ? `En cours de lecture : ${nowPlaying}` : 'Double-clique sur une ligne pour la jouer.'}</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)} /> Erreur de l'agent : Ajouté avec new Date()</label>
<label className="flex items-center gap-2"><input type="checkbox" checked={hoverBug} onChange={(e) => setHoverBug(e.target.checked)} /> Erreur de l'agent : deux classes hover</label>
<label className="flex items-center gap-2"><input type="checkbox" checked={buttonBug} onChange={(e) => setButtonBug(e.target.checked)} /> Erreur de l'agent : Créer toujours actif</label>
<p className="font-mono text-xs text-gray-400">Classes de la ligne : {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">Nouvelle playlist</button>
<ul className="mt-2 text-sm">
{created.map((p, i) => (
<li key={i}>« {p.name} » {p.isPublic ? '(publique)' : '(privée)'}{p.name.trim() === '' && <strong className="text-red-400"> playlist sans nom !</strong>}</li>
))}
</ul>
</div>
{open && (
<CreatePlaylistModal
agentBug={buttonBug}
onClose={() => setOpen(false)}
onCreate={(p) => { setCreated((list) => [...list, p]); setOpen(false); }}
/>
)}
</div>
</div>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Pourquoi addedAt est-il dans le type PlaylistTrack et pas dans le type Track ?
2. npm run lint se termine avec succès mais affiche l'avertissement : 'sortBy' is assigned a value but never used. Que fais-tu ?
Voici 2 des 7 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Clique dans l'ordre
Clique sur les éléments pour construire la condition dont dépend le bouton Créer :
- Clique dans l'ordre
Clique sur les éléments pour construire l'en-tête de la fonction qui gère l'envoi du formulaire :
- Tri horizontal
Range sur une seule ligne la cellule de la colonne Ajouté :
- Tri horizontal
Range sur une seule ligne le début du formateur de la date d'ajout :
- Éditeur de code
Composant d'affichage de playlist
- Clique dans l'ordre
Clique sur les éléments pour additionner les durées des morceaux :
- Tri vertical
Range les étapes de construction des playlists de la leçon :
- Tri vertical
Range les étapes quand la demande de tri de la playlist a changé trop de choses :
- Tri horizontal
Ordonne les éléments pour lire le nom du propriétaire de la playlist sur une seule ligne :
- Tri vertical
Range ce qui se passe après un clic sur Créer avec un nom valide :
- Éditeur de code
Interface de création de playlist
Exercices après cette leçon
- QuestionLa date d'ajout dans la playlist
- QuestionL'avertissement sur l'état inutilisé
- Clique dans l'ordreLa condition du bouton Créer
- Clique dans l'ordreLe type de l'événement d'envoi du formulaire
- Remets dans l'ordreLa cellule Ajouté tirée des données
- Remets dans l'ordreFormater la date d'ajout
- Exercice de codePratique : page de playlist
- QuestionLibrary : des identifiants au lieu de copies
- Clique dans l'ordreConstruis la somme des durées de la playlist
- Remets dans l'ordreLes playlists en trois étapes
- QuestionDeux classes hover sur une même ligne
- Remets dans l'ordreQuand le tri tourne mal
- QuestionLe fuseau horaire de la date d'ajout
- QuestionUne date bouche-trou dans la colonne Ajouté
- Remets dans l'ordreAccéder au nom du propriétaire
- Remets dans l'ordreCréer une playlist pas à pas
- Exercice de codePratique : modale de création de playlist
- QuestionUn nom fait seulement d'espaces