Cours Vibe coding avec Claude Code · Module 10: Clone de TikTok

Feed For You : un clip par écran, vérifié à l'oreille

9 min de lecture
Dans cette leçon11

Ohé ! L'équipage filme de courts clips à chaque expédition : le coffre sous le palmier, l'abordage à l'aube, l'ombre du kraken sous l'eau. Aujourd'hui, ces clips dorment dans un dossier de l'ordinateur de bord. Dans cette location, tu construis Treasure Reels, un clone de TikTok : des clips verticaux plein écran, que l'on fait défiler du pouce l'un après l'autre, avec des sons, un enregistreur, des duos et un éditeur. Tu commences par le cœur de l'application : le feed.

Ce que tu vas apprendre

  • créer le projet Treasure Reels et confier le feed à un plan construit sur une capture d'écran ;
  • lire dans Cursor le code qui décide quel clip joue et lequel s'arrête ;
  • vérifier le comportement dans le navigateur, pas seulement l'apparence : faire défiler et écouter ;
  • reconnaître les trois erreurs que l'agent commet le plus souvent avec la vidéo.

Nouveau port : le projet treasure-reels

Treasure Reels est une application à part : tu la crées donc avec la commande de la leçon 1_2, en changeant seulement le nom. Avant de cliquer sur Yes, compare la commande avec celle-ci :

npx create-next-app@latest treasure-reels --ts --eslint --tailwind --app --no-src-dir --no-cache-components --agents-md --no-agent-feedback --use-npm

Ensuite, la boucle habituelle : une session dans le dossier treasure-reels, un CLAUDE.md qui importe @AGENTS.md, Vitest avec le correctif @types/node de la leçon 4_1 et un premier commit. Pour le feed, il te faut encore quelques courts clips avec du son dans public/videos/. Filme quatre plans verticaux de quelques secondes avec ton téléphone ou, si tu as le programme ffmpeg, demande à Claude quatre clips de test, chacun avec une note de son différente. Une note différente par clip servira à la revue : tu entendras quel clip joue.

Un plan à partir d'une capture d'écran

Un feed se montre plus facilement qu'il ne se décrit. Fais une capture d'écran d'une application de courts clips et enregistre-la sous croquis/feed.png, comme les croquis de la location 4. Commence ensuite par un plan, car avec la vidéo, la plupart des erreurs se cachent dans ce que la capture ne montre pas.

Demande pour Claude Code :

/plan Construis dans Treasure Reels un feed vertical comme sur
croquis/feed.png : un clip par écran plein, défilement au pouce avec
aimantation sur le clip, une superposition avec l'auteur, la
description, les hashtags, le son et les compteurs. Types dans
types/video.ts, données dans lib/videos.ts à partir des clips de
public/videos, composants ForYouFeed et VideoInfoOverlay. Écris dans
le plan ce qui arrive à un clip qui sort de l'écran et ce qui se passe
quand le navigateur refuse de lancer un clip avec du son. N'écris pas
encore de code.

Les deux dernières questions sont des pièges. Un bon plan répond : le clip hors écran s'arrête et revient au début, le feed démarre en sourdine et a un bouton pour activer le son. Un plan qui n'en dit rien, tu le corriges avant de l'approuver, pas après le build.

Ce que Claude a écrit : les types

Ouvre types/video.ts dans Cursor. Le son et le clip ont chacun un seul type, utilisé par toute l'application :

export interface Sound {
  id: string;
  title: string; // "Hymne des pirates"
  author: string;
}

export interface Video {
  id: string;
  src: string; // "/videos/capitaine.mp4"
  poster: string; // première image comme vignette
  author: { username: string; verified: boolean };
  caption: string;
  hashtags: string[];
  sound: Sound;
  likes: number;
  comments: number;
  shares: number;
}

poster est l'image que le navigateur affiche avant le chargement du clip. sound n'est pas une chaîne, mais un objet de type Sound, car dans la leçon suivante la bibliothèque de sons étendra justement ce type au lieu d'en écrire un second, presque identique. Deux types pour le même son finissent par diverger, et le compilateur n'a aucun moyen de s'en apercevoir.

Ce que Claude a écrit : les compteurs

Les nombres de la superposition passent tous par une seule fonction de lib/format.ts :

const compact = new Intl.NumberFormat("fr-FR", {
  notation: "compact",
  maximumFractionDigits: 1,
});

export function formatCount(count: number): string {
  return compact.format(count);
}

Intl.NumberFormat est le formateur de nombres intégré au navigateur, et notation: "compact" abrège les grandes valeurs à la française. Chez nous, le test a donné 999 pour "999", "1,5 k" pour 1500 et "2,3 M" pour 2 340 000. Entre le nombre et l'abréviation se trouve une espace insécable (U+00A0), donc un test qui compare avec une espace normale échoue, même si les deux chaînes ont l'air identiques.

Ce que Claude a écrit : quel clip est à l'écran

Ouvre components/ForYouFeed.tsx. Le conteneur a les classes snap-y snap-mandatory overflow-y-scroll, et chaque diapositive h-dvh snap-start : le défilement s'arrête toujours au début d'un clip. Quel clip occupe l'écran, c'est un observateur d'intersection, l'IntersectionObserver, qui le dit : une sentinelle intégrée au navigateur qui signale quand un élément apparaît dans la vue :

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 veut dire qu'une diapositive compte comme active quand au moins 60 % de sa hauteur est visible. Le numéro de la diapositive se trouve dans l'attribut data-index. L'état change dans la fonction de rappel de l'observateur, et non directement dans le corps de l'effet : la règle de lint react-hooks/set-state-in-effect, qui rejette un état modifié directement dans un effet, n'a donc rien à reprocher ici. disconnect() au nettoyage détache la sentinelle quand le feed disparaît de la page.

Ce que Claude a écrit : un seul clip joue

Quand le clip actif change, un second effet parcourt tous les éléments <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]);

Le clip actif reçoit play(), tous les autres pause() et un retour au début. Selon MDN, play() renvoie une promesse, et un navigateur qui interdit la lecture sans action de l'utilisateur la rejette avec une erreur NotAllowedError. MDN conseille que l'interface ne suppose pas que la lecture a démarré. C'est pourquoi le second argument de then règle blocked, et qu'un bouton "Touche pour lire" apparaît sur le clip. Les clips démarrent avec muted et playsInline : d'après le guide MDN sur la lecture automatique, un son coupé ou une interaction préalable avec la page sont les conditions dans lesquelles les navigateurs laissent généralement jouer. Le bouton "Activer le son" dans le coin retire la sourdine au clic, donc après une interaction.

Ce que Claude a écrit : les références aux clips

L'effet a besoin d'accéder à chaque élément <video>, alors Claude les range dans un tableau dans un useRef, et chaque élément s'y inscrit lui-même grâce à la fonction ref :

<video
  ref={(el) => {
    videoRefs.current[i] = el;
  }}

Les accolades ne sont pas décoratives. L'écriture plus courte ref={(el) => (videoRefs.current[i] = el)} renvoie la valeur assignée, or en React 19 une fonction ref ne peut renvoyer que rien ou une fonction de nettoyage. Chez nous, npx tsc --noEmit a rejeté la version courte avec l'erreur TS2322 et la ligne Type 'HTMLVideoElement | null' is not assignable to type 'void | (() => VoidOrUndefinedOnly)', alors que npm run lint ne l'avait pas remarquée.

Ce que Claude a écrit : pas tout en même temps

Quatre clips, ce n'est rien, mais un feed de cent clips ne peut pas tous les télécharger au démarrage :

preload={Math.abs(i - active) <= 1 ? "auto" : "none"}

L'attribut preload dit au navigateur ce qu'il doit télécharger avant la lecture : none rien, auto tout le fichier. MDN précise que ce n'est qu'une indication, que le navigateur peut ignorer. Chez nous, au démarrage, le navigateur n'a téléchargé que le premier et le deuxième clip, et le troisième seulement après le passage au deuxième. Les images poster sont arrivées pour les quatre, car elles sont petites.

La revue du capitaine

  1. La pause du clip précédent. L'erreur typique de l'agent est un effet avec la seule ligne videoRefs.current[active]?.play(). Chez nous, cette version a passé le lint, tsc et le build, et après le passage au troisième clip, deux jouaient en même temps : le premier continuait en arrière-plan et le troisième à l'écran. Cherche dans le fichier (Cmd+F sur Mac, Ctrl+F sous Windows) le mot pause, puis vérifie à l'oreille : fais défiler trois clips et écoute si tu n'entends qu'une seule note.
  2. La promesse de play(). Chaque play() a une gestion du rejet. Que ton navigateur bloque ou non le son dépend de ses règles et de ton historique sur le site : le code doit donc gérer les deux issues.
  3. La clé avec l'id. Les diapositives ont key={video.id}, pas l'indice du map. Quand le feed reçoit de nouveaux clips en haut, React avec une clé d'indice réutiliserait l'ancien <video> pour un autre clip.
  4. Les compteurs via formatCount. Cherche dans le projet (Cmd+Shift+F) .likes} et .comments} : un nombre brut à l'écran signale que le formateur a été contourné.
  5. La preuve. Demande un test avec un faux lecteur comme dans la leçon 4_1 : après le changement de diapositive active, le clip précédent reçoit pause(), et un play() rejeté affiche le bouton. Chez nous, la version avec l'erreur du point 1 a échoué aux deux tests. Ensuite npm run lint, npx tsc --noEmit et npm run build.

Étape suivante

Si la revue a trouvé quelque chose, la correction passe par une seule demande étroite, par exemple : "Dans @components/ForYouFeed.tsx, les clips hors écran doivent s'arrêter et revenir au début. Ne change rien d'autre. Ensuite les tests et le lint." Le diff dans le panneau Source Control doit montrer un changement dans un seul effet, rien de plus. Quand tout joue, ou plutôt quand un seul joue à la fois, demande un commit, par exemple "Feed For You avec superposition".

Dans l'éditeur ci-dessous t'attend le feed en miniature, avec de faux clips qui comptent les secondes. Fais défiler, aime un clip et active l'erreur de l'agent pour voir combien de clips jouent en même temps.

À retenir : le capitaine ne juge pas un coffre à son éclat, il l'ouvre et regarde ce qu'il y a dedans, et un feed se vérifie à l'oreille, pas à l'œil.

Code de cette leçon : App.jsx
// Feed For You en miniature : de faux clips comptent les secondes au lieu de jouer
import { useEffect, useState } from 'react';

const clips = [
  { id: 'v1', author: 'capitaine_redbeard', caption: 'Le coffre sous le palmier', sound: 'Hymne des pirates', likes: 125400, color: 'from-sky-900 to-blue-700' },
  { id: 'v2', author: 'mary_la_noire', caption: "Abordage à l'aube", sound: 'Tambours de bataille', likes: 1500, color: 'from-red-900 to-orange-700' },
  { id: 'v3', author: 'chasseur_de_cartes', caption: 'La carte de Isla de Muerta', sound: "Chant de marin de l'île", likes: 2340000, color: 'from-emerald-900 to-teal-700' },
  { id: 'v4', author: 'mousse_tom', caption: "Quelque chose bouge sous l'eau", sound: 'Hymne des pirates', likes: 999, color: 'from-purple-900 to-fuchsia-700' },
];

const compact = new Intl.NumberFormat('fr-FR', { 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);

  // Horloge des faux clips : chaque seconde, elle ajoute du temps à chaque clip qui joue.
  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() rejeté par le navigateur (NotAllowedError)
    if (autoplayBlocked) {
      setBlocked(true);
      setPlaying((prev) => (agentBug ? prev : new Set()));
      return;
    }
    setBlocked(false);
    if (agentBug) {
      // erreur de l'agent : seulement play() pour le nouveau clip, sans pause() pour les anciens
      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) ? `▶ joue ${seconds[active] || 0} s` : "⏸ à l'arrêt"}
        </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 ? 'Activer le son' : 'Couper le son'}
        </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"
          >
            Touche pour lire
          </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">▲ Précédent</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">▼ Suivant</button>
        </div>
        <p>Clip {active + 1} sur {clips.length}. En lecture : <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) ? `joue (${seconds[i] || 0} s)` : "à l'arrêt"}, {loaded.has(i) ? 'chargé' : 'en attente (preload none)'}
            </li>
          ))}
        </ul>
        <label className="flex items-center gap-2">
          <input type="checkbox" checked={agentBug} onChange={(e) => setAgentBug(e.target.checked)} />
          Erreur de l&apos;agent : seulement play(), sans pause()
        </label>
        <label className="flex items-center gap-2">
          <input type="checkbox" checked={autoplayBlocked} onChange={(e) => setAutoplayBlocked(e.target.checked)} />
          Le navigateur rejette play() (NotAllowedError)
        </label>
      </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. 1. Que doit-il arriver, dans le feed de Treasure Reels, à un clip qui est sorti de l'écran ?

  2. 2. Pourquoi la demande de plan du feed pose-t-elle des questions sur le clip hors écran et sur le son bloqué ?

Voici 2 des 7 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Éditeur de code

    Fil de style TikTok

  • Tri horizontal

    Compose la ligne qui ne fait télécharger que le clip actif et ses voisins :

  • Clique dans l'ordre

    Construis l'instruction qui remet un clip arrêté au début (clique dans l'ordre) :

  • Éditeur de code

    Composant de superposition de la vidéo

  • Tri vertical

    Mets dans l'ordre le travail sur le feed de la leçon (à partir de la première étape) :

  • Tri horizontal

    Compose la ligne qui confie toutes les diapositives du feed à la sentinelle :

  1. QuestionLe clip hors écran
  2. QuestionLes pièges de la demande de plan
  3. Questionplay() rejeté
  4. Exercice de codePratique : fil de vidéos verticales
  5. Remets dans l'ordreL'attribut preload dans le feed
  6. QuestionLes accolades dans la fonction ref
  7. Clique dans l'ordreRetour du clip au début
  8. QuestionIntersectionObserver dans le feed
  9. Exercice de codePratique : superposition d'infos de la vidéo
  10. Remets dans l'ordreDe la capture au contrôle à l'oreille
  11. QuestionLa fonction formatCount
  12. QuestionLe champ poster dans Video
  13. Remets dans l'ordreObserver les diapositives

Articles utiles