Cours Vibe coding avec Claude Code · Module 2: Un projet Next.js avec Claude Code

La landing page de Kraken's Call, du plan jusqu'au push

10 min de lecture ·
Dans cette leçon13

Ohé ! C'est la dernière leçon du lieu, et son projet principal. Tu as le plan dans SPEC.md, le règlement dans CLAUDE.md et le journal sur GitHub. Aujourd'hui, tu construis toute la landing page comme tu construiras chaque clone de ce voyage : par petites étapes, avec une preuve après chacune.

Problème : cinq étapes d'un coup, c'est la tempête

Tu peux écrire « exécute tout le plan de SPEC.md ». Claude modifiera alors quatre fichiers en quelques minutes, et si le build casse, tu ne sais pas quelle étape l'a abîmé. /rewind annulera tout d'un coup, y compris ce qui fonctionnait. Une étape par demande te donne un petit diff à lire, une vérification et un point de retour.

Où se trouve le navire

Commence par l'état du journal : tape dans la session ! git status et compare le résultat avec ceci :

On branch feature/how-to-play
nothing to commit, working tree clean

C'est la branche de la leçon 1_5, où se trouvent déjà les commits de SPEC.md et de CLAUDE.md. « Working tree clean » signifie que la liste de Source Control est vide, et que le dernier bon état est enregistré. Si quelque chose y attend, fais d'abord un commit.

La boucle d'une section

Chaque étape du plan passera par la même boucle. Tu la connais depuis la leçon 0_6, et s'y ajoute la preuve du build :

1. Liste de Source Control vide : le bon état est enregistré.
2. Demande : une étape du plan de @SPEC.md.
3. Preuve : Claude lance npm run build et montre le résultat.
4. Revue : le diff dans Source Control et la page dans le navigateur.
5. Bien ? Commit avec une description. Mal ? /rewind et une étape plus petite.

La boucle se termine toujours par un enregistrement ou un retour en arrière, jamais par un changement non enregistré sur lequel on bâtit l'étape suivante. Garde le serveur npm run dev dans un deuxième terminal, pour jeter un œil au navigateur après chaque étape.

Étape 1 : le fichier commun de l'équipage

Session en mode Manual, et une demande plus courte que jamais dans ce lieu :

Demande pour Claude Code :

Exécute l'étape 1 de la partie « Plan de construction » de @SPEC.md
et rien de plus. À la fin, lance npm run build et montre le résultat.

L'objectif, les fichiers, les limites et la vérification sont déjà dans SPEC.md et CLAUDE.md, donc tu ne les répètes pas dans chaque conversation. Voilà ce que rapporte le travail des deux leçons précédentes.

Ce que Claude a écrit

Ouvre dans Cursor le nouveau fichier components/crew.tsx. Les types de la leçon 1_4 ont reçu le mot export :

export type CrewRole = "capitaine" | "timonier" | "cuisinier" | "bosco";

export interface CrewMember {
  name: string;
  role: CrewRole;
  level: number;
  parrot?: string;
}

export rend un nom disponible pour les autres fichiers. Plus bas se trouvent les données crew et le composant CrewCard, eux aussi avec export, et leur contenu n'a pas changé. Le fichier app/crew/page.tsx commence maintenant par une seule ligne :

import { CrewCard, crew } from "@/components/crew";

import prend des noms dans un autre fichier, et les accolades choisissent ceux que cet autre fichier exporte. @/ est l'alias de la leçon 1_2, c'est-à-dire le dossier principal du projet. La page /crew a perdu trente lignes, mais dans le navigateur elle doit avoir exactement le même aspect : vérifie-le avant le commit.

Étape 2 : le hero et l'équipage sur la page d'accueil

La demande reste la même, seul le numéro de l'étape change. Dans app/page.tsx, le hero n'est plus toute la page mais la première section, et en dessous se trouve la section de l'équipage :

<section className="px-6 py-16">
  <h2 className="text-center text-3xl font-bold text-red-600">Équipage</h2>
  <div className="mx-auto mt-8 grid max-w-4xl grid-cols-1 gap-4 md:grid-cols-3">
    {crew.map((member) => (
      <CrewCard key={member.name} member={member} />
    ))}
  </div>
</section>

<section> regroupe une partie de la page, et <h2> est un titre de deuxième niveau, car <h1> appartient au nom du jeu dans le hero. La grille et crew.map sont le même code que sur la page /crew : les cartes n'ont pas été copiées, mais importées. Toute la page est maintenant enveloppée dans <div className="bg-black text-white">, donc le fond noir s'étend sur toutes les sections.

Étape 3 : Comment jouer

Les trois étapes du jeu, Claude les a écrites sous forme de données, comme l'équipage :

const steps = [
  { title: "Réunis l'équipage", text: "Choisis trois pirates et donne-leur un rôle à bord." },
  { title: "Trace le cap", text: "Prépare ta route sur la carte et évite les récifs." },
  { title: "Vaincs le kraken", text: "Gagne la bataille avant que le kraken n'entraîne le navire sous l'eau." },
];

Il n'a pas écrit de type, car TypeScript le déduit des valeurs, comme le disait la leçon 1_4 : chaque étape a title et text comme texte. La section affiche les étapes dans une liste numérotée :

<ol className="mx-auto mt-8 grid max-w-4xl grid-cols-1 gap-4 md:grid-cols-3">
  {steps.map((step, index) => (
    <li key={step.title} className="rounded-lg bg-gray-900 p-6">
      <p className="text-sm font-semibold text-yellow-400">Étape {index + 1}</p>
      <h3 className="mt-2 text-xl font-bold">{step.title}</h3>
      <p className="mt-2 text-gray-300">{step.text}</p>
    </li>
  ))}
</ol>

<ol> est une liste numérotée, et <li> son élément. index est le numéro de l'étape compté à partir de zéro, d'où le index + 1 sur la page. Sur un téléphone, les étapes sont l'une sous l'autre, et à partir de 768 pixels sur trois colonnes.

Étapes 4 et 5 : le pied de page et les métadonnées

Le pied de page se trouve sous <main>, car il ne fait pas partie du contenu principal de la page :

<footer className="border-t border-gray-800 px-6 py-8 text-center text-sm text-gray-400">
  <p>Kraken&apos;s Call, 2026</p>
  <a href="https://github.com/TON-LOGIN/krakens-call" className="mt-2 inline-block text-yellow-400 underline hover:text-yellow-300">
    Code du jeu sur GitHub
  </a>
</footer>

<a> avec l'attribut href est un lien, et TON-LOGIN est à remplacer par ton identifiant. La classe underline reste en permanence, car hover: ne fonctionne pas sur un téléphone, et un lien doit ressembler à un lien sans qu'on le survole. L'étape 5 change dans app/layout.tsx le titre dans metadata en « Kraken's Call », pour que l'onglet du navigateur ne dise pas « Create Next App », et lang="en" en lang="fr" : selon MDN, l'attribut lang permet aux lecteurs d'écran de prononcer le texte dans la bonne langue. J'ai vérifié ce code dans une copie du projet : npm run build, npm run lint et npx tsc --noEmit passent sans erreurs.

Casse et récupère

Casse le build exprès une fois, pour que le filet de sécurité ne reste pas de la théorie. Après le commit d'une étape quelconque, donne cette demande :

Dans @components/crew.tsx, change dans l'interface CrewMember le nom
du champ level en rank. Change cette seule ligne et ne lance aucune
commande.

Puis lance la vérification toi-même, en tapant ! npm run build. Le résultat se termine à peu près ainsi :

✓ Compiled successfully in 308ms
  Running TypeScript ...
components/crew.tsx(11,42): error TS2353: Object literal may only specify known properties, and 'level' does not exist in type 'CrewMember'.
components/crew.tsx(25,39): error TS2339: Property 'level' does not exist on type 'CrewMember'.
Failed to type check.

« Compiled successfully » ne signifie pas le succès : seule la vérification des types a découvert que les données et la carte utilisent encore level, alors que le contrat ne le connaît plus. Tape /rewind, choisis cette demande et Restore code. La liste de Source Control est de nouveau vide, et ! npm run build passe. Quand l'erreur est réelle, demande à Claude de lire le message et de corriger seulement sa cause. Après deux corrections ratées, n'en ajoute pas une troisième : reviens avec /rewind au bon état et donne une demande plus petite.

Ce que /rewind n'annulera pas ici

Le checkpoint se souvient des fichiers que Claude modifie avec ses outils d'édition. Dans ce projet, les limites de la leçon 0_6 ressemblent à ceci :

  • un paquet installé avec npm install : package.json et package-lock.json sont modifiés par une commande, donc si Claude ne les a pas édités auparavant avec son outil, /rewind ne les rétablira pas ; c'est git restore package.json package-lock.json qui le fera ;
  • un commit : git commit est aussi une commande, donc l'enregistrement reste dans l'historique même après le retour en arrière des fichiers ;
  • un push : ce qui est parti sur GitHub a quitté ton ordinateur.

C'est pourquoi tu fais le commit avant une étape risquée, et le push seulement après la revue.

Push sur GitHub

Quand chacune des cinq étapes a son commit, demande de fusionner la branche et d'envoyer :

Demande pour Claude Code :

Fusionne la branche feature/how-to-play dans main et envoie main sur
GitHub. Montre les commandes avant de les lancer, et à la fin le
résultat de git log --oneline.

Claude demandera l'accord pour trois commandes :

git switch main
git merge feature/how-to-play
git push

git switch main revient sur la branche principale, et git merge y verse les commits de la branche de fonctionnalité. Rien n'a changé sur main entre-temps, donc Git la fait simplement avancer et affichera « Fast-forward ». Après la fusion, git status dit « Your branch is ahead of 'origin/main' », c'est-à-dire que main connaît son dépôt sur GitHub et qu'un simple git push suffit. Avant d'accepter, vérifie qu'il n'y a nulle part de --force.

La liste de contrôle du capitaine

Avant d'envoyer le lien au mentor, parcours la liste :

  1. Build : npm run build, npm run lint et npx tsc --noEmit passent, et tu as vu les résultats toi-même.
  2. Types honnêtes : il n'y a ni any ni @ts-ignore dans les diffs.
  3. Écran étroit : après avoir réduit la fenêtre à la largeur d'un téléphone, les cartes et les étapes sont l'une sous l'autre, et le texte ne touche pas les bords.
  4. Contraste : chaque texte se détache nettement du fond, et le lien est souligné.
  5. Secrets : il n'y a pas de .env dans le dépôt, car le .gitignore de l'assistant ignore tout fichier qui commence par .env.
  6. Journal : git log --oneline montre un petit commit par étape, et les titres disent ce qui a changé.

Erreur typique de l'agent dans cette boucle : il fait plus que ce que tu as demandé, par exemple il ajoute « au passage » le pied de page à l'étape 3. Tu le verras dans Source Control comme un diff plus gros que ce qu'annonçait l'étape. Réponds avec /rewind et répète la demande avec la précision « seulement l'étape 3 ».

Étape suivante

Ouvre le dépôt dans le navigateur et colle son adresse dans la tâche pour le mentor. Il vérifiera SPEC.md avec le plan, le CLAUDE.md court avec l'import @AGENTS.md, les commits par petites étapes et un build sans erreurs. Dans le lieu suivant, tu commenceras le clone de Twitter et tu feras passer chacune de ses fonctionnalités par la même boucle. Dans l'éditeur ci-dessous t'attend une landing page prête en HTML : réduis l'aperçu et parcours la liste de contrôle de tes propres yeux.

Retiens : chaque clone de ce voyage, tu le construiras avec la même boucle, et aujourd'hui tu l'as parcourue pour la première fois d'un port à l'autre.

Code de cette leçon : index.html
<!DOCTYPE html>
<html lang="fr">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Kraken's Call</title>
    <!-- Tailwind CSS 4 depuis le CDN : version pour apprendre, pas pour la production -->
    <script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>
</head>
<body class="bg-black text-white">
    <!-- La landing page de la leçon 1_8 en HTML ordinaire. Dans le projet Next.js, c'est app/page.tsx avec className -->
    <main>
        <!-- Étape 2 : le hero comme première section -->
        <section class="flex min-h-screen items-center justify-center px-6">
            <div class="max-w-xl text-center">
                <h1 class="text-4xl font-bold text-red-600 md:text-6xl">Kraken's Call</h1>
                <p class="mt-4 text-lg text-gray-300">
                    Un jeu de pirates dans le navigateur : réunis un équipage et affronte le kraken.
                </p>
                <button class="mt-8 rounded-lg bg-yellow-500 px-6 py-3 font-semibold text-black transition-colors hover:bg-yellow-600">
                    Rejoindre l'équipage
                </button>
            </div>
        </section>

        <!-- Étape 2 : la section de l'équipage, les mêmes cartes que sur la page /crew -->
        <section class="px-6 py-16">
            <h2 class="text-center text-3xl font-bold text-red-600">Équipage</h2>
            <div class="mx-auto mt-8 grid max-w-4xl grid-cols-1 gap-4 md:grid-cols-3">
                <article class="rounded-lg border border-yellow-500 bg-gray-900 p-6">
                    <h3 class="text-xl font-bold">Anne Bonny</h3>
                    <p class="mt-2 text-gray-300">capitaine, niveau 10</p>
                    <p class="mt-2 text-yellow-400">Perroquet : Capitaine Plume</p>
                </article>
                <article class="rounded-lg border border-yellow-500 bg-gray-900 p-6">
                    <h3 class="text-xl font-bold">Jack Rackham</h3>
                    <p class="mt-2 text-gray-300">timonier, niveau 7</p>
                </article>
                <article class="rounded-lg border border-yellow-500 bg-gray-900 p-6">
                    <h3 class="text-xl font-bold">Mary Read</h3>
                    <p class="mt-2 text-gray-300">cuisinier, niveau 5</p>
                </article>
            </div>
        </section>

        <!-- Étape 3 : Comment jouer, liste numérotée -->
        <section class="px-6 py-16">
            <h2 class="text-center text-3xl font-bold text-red-600">Comment jouer</h2>
            <ol class="mx-auto mt-8 grid max-w-4xl grid-cols-1 gap-4 md:grid-cols-3">
                <li class="rounded-lg bg-gray-900 p-6">
                    <p class="text-sm font-semibold text-yellow-400">Étape 1</p>
                    <h3 class="mt-2 text-xl font-bold">Réunis l'équipage</h3>
                    <p class="mt-2 text-gray-300">Choisis trois pirates et donne-leur un rôle à bord.</p>
                </li>
                <li class="rounded-lg bg-gray-900 p-6">
                    <p class="text-sm font-semibold text-yellow-400">Étape 2</p>
                    <h3 class="mt-2 text-xl font-bold">Trace le cap</h3>
                    <p class="mt-2 text-gray-300">Prépare ta route sur la carte et évite les récifs.</p>
                </li>
                <li class="rounded-lg bg-gray-900 p-6">
                    <p class="text-sm font-semibold text-yellow-400">Étape 3</p>
                    <h3 class="mt-2 text-xl font-bold">Vaincs le kraken</h3>
                    <p class="mt-2 text-gray-300">Gagne la bataille avant que le kraken n'entraîne le navire sous l'eau.</p>
                </li>
            </ol>
        </section>
    </main>

    <!-- Étape 4 : le pied de page sous main, lien souligné en permanence -->
    <footer class="border-t border-gray-800 px-6 py-8 text-center text-sm text-gray-400">
        <p>Kraken's Call, 2026</p>
        <a href="https://github.com/TON-LOGIN/krakens-call" class="mt-2 inline-block text-yellow-400 underline hover:text-yellow-300">
            Code du jeu sur GitHub
        </a>
    </footer>
    <!-- Liste de contrôle : réduis l'aperçu à la largeur d'un téléphone. Les cartes et les étapes sont-elles l'une sous l'autre ? Le texte touche-t-il les bords ? -->
</body>
</html>

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. Après une étape du plan, npm run build se termine par une erreur de types. Que fais-tu en premier ?

  2. 2. Claude annonce : étape terminée, npm run build passe. Que ce build ne vérifiera pas à ta place ?

  3. 3. Pourquoi construis-tu la landing page avec une étape du plan par demande, et non tout le plan d'un coup ?

Tâches pratiques dans le jeu

  • Tri vertical

    Ordonne les étapes de l'exercice où tu casses le build exprès et reviens à la version qui fonctionne :

  • Clique dans l'ordre

    Clique sur les éléments dans l'ordre pour composer la commande qui verse la branche feature/how-to-play dans la branche courante :

  1. QuestionQuiz : le build ne passe pas
  2. Remets dans l'ordreOrdre : casse et récupère
  3. QuestionQuiz : ce que le build ne vérifiera pas
  4. Clique dans l'ordreOrdre : la commande de fusion d'une branche
  5. QuestionQuiz : une étape par demande
  6. Projet à envoyerEnvoie la landing page de Kraken's Call
  7. VidéoRésumé du module

Articles utiles