Cours Vibe coding avec Claude Code · Module 13: Clone de Twitch
Les archives des meilleurs moments : catégories, clips et replays
Dans cette leçon9
La chaîne a sa carte de visite mais le nouveau spectateur ne sait pas encore quoi chercher. Il lui faut une page où il parcourt les catégories, voit qui diffuse en ce moment et regarde de courts clips avec les meilleurs moments. Le streamer, lui, veut que la traversée ne disparaisse pas après la diffusion : l'enregistrement reste dans les archives, découpé en chapitres, et le spectateur peut en tirer un clip. Dans cette leçon, Claude construira la page Parcourir avec trois onglets, la page du replay et la création de clips. Toi, tu vérifieras où le clip naît vraiment.
Ce que tu vas apprendre
- commander une grande fonctionnalité en mode plan et réutiliser tout de suite la convention d'onglets de
CLAUDE.md, sans une copie de code de plus ; - lire des couvertures à proportions fixes, qui ne sautent pas pendant le chargement ;
- comprendre qu'un clip est un intervalle de temps dans l'enregistrement, et que c'est le serveur qui le surveille ;
- vérifier chaque onglet dans le navigateur, avec Claude in Chrome ou à la main.
Demande pour Claude Code
Cette étape touche des données, trois composants de cartes, deux pages, une route d'API et le lecteur : tu commences donc par un plan, comme dans la leçon 1_6 :
Demande pour Claude Code :
/plan Ajoute la page /browse avec les onglets Catégories, En direct
et Clips (via Tabs, conformément à CLAUDE.md). Catégories : une grille
de couvertures 3:4 avec le nombre de spectateurs, couvertures de
images.unsplash.com via next/image. En direct : les chaînes de
lib/channels.ts qui diffusent. Clips : un clip est un intervalle de
temps dans un replay (vodId, start, end), sans découpe de la vidéo.
La page /videos/[id] avec le lecteur du replay, la liste des chapitres
et le bouton Créer un clip. Le clip est enregistré par la route
POST /api/clips : le serveur calcule lui-même 30 secondes autour du
moment indiqué et rejette un moment hors de l'enregistrement.
Des tests Vitest pour les chapitres et la plage du clip.
À la fin npm run test -- --run, npm run lint, npx tsc --noEmit
et npm run build.Dans le plan, vérifie un point : Claude ne compte-t-il pas découper la vidéo dans le navigateur ? Si le plan parle de "rogner le fichier" dans un composant, réponds "No, keep planning" et rappelle qu'un clip est un intervalle.
Ce que Claude a écrit : des onglets issus de la convention
Ouvre app/browse/page.tsx. La page n'a pas son propre code d'onglets, seulement une liste et le composant commun de la leçon 12_2 :
// app/browse/page.tsx
const BROWSE_TABS = [
{ key: "categories", label: "Catégories" },
{ key: "live", label: "En direct" },
{ key: "clips", label: "Clips" },
] as const;La page commence par un titre Parcourir, dessous se trouve <Tabs tabs={BROWSE_TABS} active={active} basePath="/browse" />, puis trois sections dont chacune ne se dessine que pour son onglet. La section des catégories tient en une expression : categories.map((c) => <CategoryCard key={c.slug} category={c} />). C'est la preuve que la ligne de CLAUDE.md a fonctionné : Claude n'a pas écrit une sixième copie.
Ce que Claude a écrit : des couvertures qui ne sautent pas
Ouvre components/CategoryCard.tsx. La couverture d'une catégorie est plus haute que large, comme la boîte d'un jeu :
// components/CategoryCard.tsx
<div className="relative aspect-3/4 overflow-hidden rounded-lg bg-zinc-800">
<Image src={category.cover} alt="" fill sizes="(min-width: 1024px) 20vw, 45vw" className="object-cover" />
</div>Sous la couverture se trouvent le nom de la catégorie dans un h3 et le nombre de spectateurs. aspect-3/4 réserve la place aux proportions 3 sur 4 avant que l'image soit téléchargée, donc le texte sous la carte ne rebondit pas. fill étire l'image sur son parent avec relative, sizes dit au navigateur quelle part de l'écran occupera la carte, et object-cover rogne la photo à la forme voulue. Tout cela, tu le connais depuis la leçon 3_1. De là vient aussi l'entrée remotePatterns pour images.unsplash.com dans next.config.ts. Sans elle, next build passe, et l'image venue d'un autre serveur fait tomber la page seulement dans le navigateur. La carte d'une chaîne en direct, components/LiveCard.tsx, fonctionne de la même façon, avec aspect-video et un badge EN DIRECT, et mène à la page de la chaîne. Là, l'onglet Replays de la leçon 12_2 a reçu une liste de liens vers /videos/[id].
Un clip est un intervalle, pas un nouveau fichier
Découper un fragment de film est un travail lourd : il faut lire le fichier, réencoder un morceau et l'enregistrer comme une nouvelle vidéo. Cela se fait sur le serveur, avec un programme comme ffmpeg, avec lequel tu as fabriqué le fichier de test dans la leçon 12_1. Un composant React dans le navigateur du spectateur est un mauvais endroit pour ce travail : le téléphone devrait télécharger tout l'enregistrement et réencoder un morceau. Notre clone prend une voie plus simple : il enregistre seulement un intervalle de temps dans un enregistrement existant. Ouvre components/ClipPlayer.tsx :
// components/ClipPlayer.tsx
<video
src={`${vod.src}#t=${clip.start},${clip.end}`}
controls
preload="metadata"
className="aspect-video w-full rounded-lg bg-black"
/>#t=40,55 à la fin de l'adresse est un fragment média. MDN le décrit comme un moyen de ne lire qu'une partie du fichier : du premier nombre de secondes au second. Sous le lecteur se trouvent le titre du clip dans un h3 et le nom de l'enregistrement avec la plage, par exemple 0:40-0:55. Chez nous, Chrome a placé le clip à 0:40, et après le démarrage de la lecture il s'est arrêté tout seul à 55,1 secondes. Souviens-toi que ce n'est pas une protection : les contrôles affichent tout l'enregistrement (0:40 / 1:00), et le retour à la 5e seconde a marché sans résistance.
Le contrôle côté serveur : la plage du clip
Le bouton Créer un clip envoie seulement vodId et la seconde courante. La durée du clip et ses bornes sont calculées par le serveur, comme la serrure de la leçon 8_3, car on peut envoyer la requête sans passer par le bouton. Ouvre lib/clipRange.ts :
// lib/clipRange.ts
export const CLIP_SECONDS = 30; // règle de notre clone
export function clipRange(at: number, duration: number): { start: number; end: number } | null {
if (!Number.isFinite(at) || at < 0 || at > duration) return null;
const start = Math.max(0, Math.min(Math.round(at) - CLIP_SECONDS / 2, duration - CLIP_SECONDS));
return { start, end: Math.min(duration, start + CLIP_SECONDS) };
}Trente secondes sont notre règle, pas celle de Twitch. Number.isFinite rejette NaN, c'est-à-dire le résultat de Number("abc"). Math.min et Math.max décalent le clip pour qu'il ne dépasse ni avant le début ni après la fin de l'enregistrement. Le test vérifie le clip à la 3e seconde (0-30) et à la 58e (30-60). La route app/api/clips/route.ts lit d'abord le corps de la requête avec request.json().catch(() => null), puis cherche l'enregistrement par vodId (s'il manque : 404). Ensuite elle calcule const range = clipRange(Number(body.at), vod.duration) et répond 400 si elle reçoit null. À la fin, elle enregistre le clip et répond 201. Vérifie-la pendant que npm run dev tourne :
curl -s -w ' %{http_code}\n' -X POST -H 'Content-Type: application/json' -d '{"vodId":"traversee-1","at":9999}' localhost:3000/api/clips-w ajoute le code de la réponse en fin de ligne. Chez nous est sorti {"error":"Ce moment est hors de l'enregistrement"} 400, et pour un enregistrement inconnu, 404. Les clips sont conservés dans un tableau sur globalThis, pour la raison de la leçon 11_2 : la route et la page verraient sinon des copies séparées.
Ce que Claude a écrit : des chapitres depuis une copie triée
Le streamer ajoute les chapitres pendant le montage, dans un ordre quelconque, donc dans les données ils peuvent ne pas être rangés. Ouvre lib/chapters.ts :
// lib/chapters.ts
export function sortChapters(chapters: readonly Chapter[]): Chapter[] {
return [...chapters].sort((a, b) => a.start - b.start);
}
export function currentChapter(chapters: readonly Chapter[], time: number): Chapter | undefined {
return sortChapters(chapters).findLast((chapter) => chapter.start <= time);
}C'est la même règle que dans l'analyseur d'émotes : une copie avant le tri et readonly dans le type. findLast cherche depuis la fin, donc il renvoie le dernier chapitre commencé avant la seconde courante. formatTime, du même fichier, transforme les secondes en m:ss ou h:mm:ss (65,9 secondes donnent "1:05"), et la liste des chapitres affiche formatTime(ch.start) avant le titre. VodPlayer calcule le chapitre pendant le rendu à partir de time, que fixe onTimeUpdate de l'élément <video>. MDN indique que cet évènement arrive environ de 4 à 66 fois par seconde, selon la charge, ce qui suffit pour afficher le chapitre.
La revue du capitaine
- Des fonctions d'aide inventées. Une erreur typique d'un agent : un
createClipdans le navigateur qui appellegenerateId(),getCurrentUser()etgetCurrentStream(), bien que personne ne les ait écrits. Chez nous,npm run lints'est tu devant un tel fichier, etnpx tsc --noEmita signaléCannot find name 'generateId'et deux erreurs semblables. La même version calculaitcurrentTimestamp - duration / 2, soit un début négatif à la troisième seconde de l'enregistrement. - État mort. Cherche
isPlaying. L'agent aimeconst [isPlaying, setIsPlaying] = useState(false)etautoPlay={isPlaying}, alors que rien ne modifie cet état. Chez nous, lint n'a donné qu'un avertissement'setIsPlaying' is assigned a value but never usedet s'est terminé en succès : lis donc les avertissements, ne les fais pas défiler. - Couvertures. Chaque
Imageavecfilla un parent avecrelativeet des proportions. - Navigateur. C'est l'étape qu'aucun test ne remplace. Avec Claude in Chrome de la leçon 3_8, une seule demande suffit :
Ouvre localhost:3000/browse et parcours les onglets Catégories,
En direct et Clips. Sur chacun, vérifie que les cartes s'affichent
et regarde la console pour les erreurs. Sur /videos/traversee-1 clique
sur le chapitre Lecteur, puis sur Créer un clip et vérifie que le clip
apparaît dans l'onglet Clips. Dis-moi ce que tu vois.Sans l'extension, fais la même chose à la main. Chez nous, les trois onglets ont affiché des cartes, la console était vide, le chapitre est passé à "Lecteur", et POST /api/clips a répondu 201.
Étape suivante
Quand la revue passe, demande un commit "Parcourir, clips et chapitres des replays". Puis une petite étape : "Sur la page d'une catégorie, affiche les chaînes en direct de cette catégorie, d'abord un plan". Le clone a déjà de quoi se vanter, mais le port est encore loin : dans les leçons suivantes, tu l'enfermeras dans un conteneur et tu monteras un pipeline qui vérifie chaque modification. Dans l'éditeur ci-dessous t'attend la page Parcourir en miniature : change d'onglet et crée des clips à partir d'un faux enregistrement.
Retiens ceci : les archives valent autant que la carte qui y mène, et les ciseaux à ruban, c'est le bosco qui les garde dans la cale, pas le spectateur sur le pont.
Code de cette leçon : App.tsx
// Parcourir en miniature : onglets, couvertures 3:4, clip comme intervalle calculé par un faux serveur, et chapitres
import { useState } from 'react';
interface Chapter {
start: number;
title: string;
}
interface Clip {
id: string;
start: number;
end: number;
}
const DURATION = 60; // le replay dure une minute
const CLIP_SECONDS = 30; // règle de notre clone
const CHAPTERS: readonly Chapter[] = Object.freeze([
{ start: 40, title: 'Chat et émotes' },
{ start: 0, title: "Accueil de l'équipage" },
{ start: 15, title: 'Lecteur' },
]);
const CATEGORIES = [
{ slug: 'programmation', name: 'Programmation', viewers: 1247, colors: 'from-sky-600 to-indigo-900' },
{ slug: 'chants-de-marins', name: 'Chants de marins', viewers: 310, colors: 'from-amber-500 to-rose-800' },
{ slug: 'navigation', name: 'Navigation', viewers: 88, colors: 'from-emerald-500 to-teal-900' },
];
const TABS = [
{ key: 'categories', label: 'Catégories' },
{ key: 'live', label: 'En direct' },
{ key: 'clips', label: 'Clips' },
] as const;
type BrowseTab = (typeof TABS)[number]['key'];
function sortChapters(chapters: readonly Chapter[]): Chapter[] {
return [...chapters].sort((a, b) => a.start - b.start);
}
function currentChapter(chapters: readonly Chapter[], time: number): Chapter | undefined {
return sortChapters(chapters).findLast((chapter) => chapter.start <= time);
}
function clipRange(at: number, duration: number): { start: number; end: number } | null {
if (!Number.isFinite(at) || at < 0 || at > duration) return null;
const start = Math.max(0, Math.min(Math.round(at) - CLIP_SECONDS / 2, duration - CLIP_SECONDS));
return { start, end: Math.min(duration, start + CLIP_SECONDS) };
}
function formatTime(seconds: number): string {
const s = Math.floor(seconds);
return Math.floor(s / 60) + ':' + String(s % 60).padStart(2, '0');
}
// Dans le projet l'id vient de crypto.randomUUID() ; ici un compteur suffit
let nextId = 1;
// Faux serveur : il calcule lui-même la plage ; la version de l'agent accepte ce qu'a calculé le navigateur
function fakeServer(body: { at: number; start?: number; end?: number }, trustClient: boolean) {
if (trustClient && body.start !== undefined && body.end !== undefined) {
return { status: 201, clip: { id: 'c' + nextId++, start: body.start, end: body.end } };
}
const range = clipRange(body.at, DURATION);
if (!range) return { status: 400, clip: null };
return { status: 201, clip: { id: 'c' + nextId++, ...range } };
}
export default function App() {
const [active, setActive] = useState<BrowseTab>('categories');
const [time, setTime] = useState(3);
const [clips, setClips] = useState<Clip[]>([]);
const [trustClient, setTrustClient] = useState(false);
const [status, setStatus] = useState('');
const chapter = currentChapter(CHAPTERS, time);
function createClip() {
// La version de l'agent calcule la plage dans le navigateur : at - 15, sans les bornes du replay
const body = trustClient ? { at: time, start: time - CLIP_SECONDS / 2, end: time + CLIP_SECONDS / 2 } : { at: time };
const res = fakeServer(body, trustClient);
if (res.clip) {
const clip = res.clip;
setClips((prev) => [clip, ...prev]);
}
setStatus('Le serveur a répondu ' + res.status);
}
return (
<div className="min-h-screen space-y-4 bg-zinc-950 p-4 text-zinc-100">
<h1 className="text-2xl font-bold">Parcourir</h1>
<nav aria-label="Onglets" className="flex gap-1 border-b border-zinc-800">
{TABS.map((tab) => (
<button
key={tab.key}
type="button"
onClick={() => setActive(tab.key)}
aria-current={tab.key === active ? 'page' : undefined}
className={tab.key === active ? 'border-b-2 border-purple-500 px-4 py-2 font-semibold' : 'border-b-2 border-transparent px-4 py-2 text-zinc-400'}
>
{tab.label}
</button>
))}
</nav>
{active === 'categories' && (
<section className="grid max-w-md grid-cols-3 gap-3">
{CATEGORIES.map((c) => (
<article key={c.slug}>
<div className={'aspect-3/4 rounded-lg bg-linear-to-b ' + c.colors} />
<h2 className="mt-2 font-semibold">{c.name}</h2>
<p className="text-sm text-zinc-400">{c.viewers} spectateurs</p>
</article>
))}
</section>
)}
{active === 'live' && <p>Capitaine Barbe-Rousse diffuse : Traversée de la mer du Code (1247 spectateurs)</p>}
{active === 'clips' && (
<section className="space-y-3">
<label className="block text-sm">
Faux replay, seconde {formatTime(time)} sur {formatTime(DURATION)}
<input type="range" min={0} max={DURATION} value={time} onChange={(e) => setTime(Number(e.target.value))} className="block w-full" aria-label="Seconde du replay" />
</label>
<p>Chapitre : <strong>{chapter?.title ?? 'aucun'}</strong></p>
<ol className="text-sm text-zinc-400">
{sortChapters(CHAPTERS).map((ch) => (
<li key={ch.start}>{formatTime(ch.start)} {ch.title}</li>
))}
</ol>
<button type="button" onClick={createClip} className="rounded bg-purple-600 px-4 py-2 font-semibold">
Créer un clip
</button>
<p role="status">{status}</p>
<ul className="space-y-1">
{clips.map((clip) => (
<li key={clip.id} className={clip.start < 0 || clip.end > DURATION ? 'text-red-400' : ''}>
Clip {formatTime(Math.max(0, clip.start))}-{formatTime(clip.end)} (début {clip.start}, fin {clip.end})
</li>
))}
</ul>
<label className="flex items-center gap-2 text-sm">
<input type="checkbox" checked={trustClient} onChange={(e) => setTrustClient(e.target.checked)} />
Version de l'agent : le navigateur calcule la plage, le serveur l'accepte
</label>
</section>
)}
</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. Qu'est-ce qu'un clip dans Live from the Deck ?
2. Qui, dans Live from the Deck, calcule le début et la fin d'un nouveau clip ?
Voici 2 des 10 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Tri horizontal
Compose l'adresse qui lit le clip de la 40e à la 55e seconde du replay (une seule ligne) :
- Éditeur de code
Construis une page de navigation par catégories
- Tri horizontal
Compose l'intérieur de sortChapters, qui trie une copie des chapitres (une seule ligne) :
- Tri vertical
Ordonne les étapes de la route qui enregistre un clip :
- Éditeur de code
Crée un lecteur de clip
- Tri vertical
Ordonne les éléments de CategoryCard en partant du haut :
- Clique dans l'ordre
Construis l'appel qui affiche le début d'un chapitre sous la forme m:ss
- Tri vertical
Les chapitres sont rangés dans les données comme 0:40, 0:00, 0:15. Ordonne-les comme les affichera la liste issue de sortChapters :
- Tri vertical
Ordonne le chemin du clip, du clic à l'onglet Clips :
- Clique dans l'ordre
Construis la ligne de la route POST /api/clips qui calcule la plage du clip
- Tri vertical
Ordonne le chemin du spectateur, de la page Parcourir au replay :
- Tri horizontal
Compose le corps de la fonction pickTab (une seule ligne) :
- Tri vertical
Ordonne les éléments de ClipPlayer en partant du haut :
- Tri horizontal
Compose l'expression qui dessine les cartes dans l'onglet Catégories (une seule ligne) :
- Tri horizontal
Compose le corps de la fonction currentChapter (une seule ligne) :
- Tri vertical
Ordonne les éléments de la page Parcourir en partant du haut :
- Tri horizontal
Compose le résultat de formatTime(65.9) pour un replay de moins d'une heure (une seule ligne) : 1:05
Exercices après cette leçon
- QuestionQuiz : ce qu'est un clip
- QuestionQuiz : qui calcule la plage du clip
- Remets dans l'ordreTri : l'adresse du clip
- Exercice de codePratique : parcourir les catégories
- QuestionQuiz : un fragment média n'est pas une serrure
- Remets dans l'ordreTri : les chapitres depuis une copie
- Remets dans l'ordreTri : la route POST /api/clips
- Exercice de codePratique : lecteur de clip
- QuestionQuiz : le chapitre courant
- Remets dans l'ordreTri : la carte de catégorie
- Clique dans l'ordreConstruction : le temps d'un chapitre
- QuestionQuiz : clipRange au début du replay
- Remets dans l'ordreTri : la liste des chapitres
- Remets dans l'ordreTri : le chemin du clip
- Clique dans l'ordreConstruction : la plage du clip sur le serveur
- Remets dans l'ordreTri : le chemin du spectateur
- Remets dans l'ordreTri : pickTab en une ligne
- QuestionQuiz : d'où le lecteur connaît le chapitre
- Remets dans l'ordreTri : le lecteur de clip
- Remets dans l'ordreTri : la grille des catégories
- QuestionQuiz : l'état mort isPlaying
- Remets dans l'ordreTri : le chapitre courant
- QuestionQuiz : les fonctions d'aide inventées
- Remets dans l'ordreTri : la page Parcourir de haut en bas
- QuestionQuiz : aria-pressed sur le bouton S'abonner
- Remets dans l'ordreTri : le résultat de formatTime
- QuestionQuiz : ce que tu vérifies dans le navigateur