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

Tailwind CSS : lis les classes que Claude écrit

10 min de lecture ·
Dans cette leçon9

Le projet est debout mais le site ressemble encore à un modèle Next.js. Il est temps pour la première section de Kraken's Call. Claude Code l'écrira avec Tailwind CSS, et toi, tu apprendras à lire ce qu'il a écrit.

Problème : un bouton avec neuf classes

Claude te rendra un bouton avec une longue suite de classes. Si tu ne les lis pas, tu ne sais pas si le bouton est lisible sur un téléphone, si le texte se détache du fond, ni si l'agent n'a pas utilisé une syntaxe vieille de deux ans. Tu n'as pas à retenir des centaines de classes : il suffit de reconnaître quelques familles, et le reste, tu le vérifies dans l'aide-mémoire ci-dessous ou sur tailwindcss.com.

Tailwind en un paragraphe

Tailwind CSS est un framework CSS de type utility-first : au lieu d'écrire tes propres règles CSS, tu composes l'apparence avec de petites classes toutes prêtes, dont chacune fait une seule chose. L'assistant de la leçon précédente l'a installé d'emblée. Voici un bouton rouge en CSS ordinaire :

.button {
  background-color: #dc2626;
  color: white;
  padding: 12px 24px;
  border-radius: 8px;
}

La règle se trouve dans un fichier CSS à part, et dans le HTML il ne reste que le nom button, donc pour savoir à quoi ressemble le bouton, tu ouvres deux fichiers. Un bouton semblable avec Tailwind tient sur une seule ligne :

<button class="bg-red-600 text-white px-6 py-3 rounded-lg">Rejoins l'équipage !</button>

Chaque classe est une voile : bg-red-600 donne le fond rouge, text-white le texte blanc, px-6 et py-3 les marges intérieures, et rounded-lg les coins arrondis. Dans du HTML ordinaire, l'attribut s'appelle class, et dans les fichiers .tsx d'un projet Next.js, className, car class est un mot réservé en JavaScript. Les classes elles-mêmes sont identiques.

Demande pour Claude Code

Lance le serveur de la leçon précédente (npm run dev dans un deuxième terminal) et donne dans la session, dans le dossier krakens-call, cette demande :

Demande pour Claude Code :

Remplace le contenu de @app/page.tsx par une section hero pour
Kraken's Call : fond noir sur toute la hauteur de l'écran, contenu
centré à la verticale et à l'horizontale, titre rouge « Kraken's
Call », une phrase de description du jeu et un bouton doré
« Rejoindre l'équipage », plus foncé au survol. Uniquement des
classes Tailwind, pas de nouveaux fichiers CSS ni de nouveaux
paquets. À la fin, lance npm run build et npm run lint et montre le
résultat.

La demande décrit l'apparence avec des mots, pas avec des classes : les classes, c'est Claude qui les choisit, et toi, tu les vérifies. La contrainte « uniquement des classes Tailwind » veille à ce qu'aucun fichier CSS à part n'apparaisse, et les deux vérifications à la fin prouvent que le code se construit et passe le linter.

Ce que Claude a écrit

Ouvre dans Cursor app/page.tsx et lis du haut vers le bas, morceau par morceau. D'abord le conteneur, c'est-à-dire l'élément <main>, qui englobe toute la section :

<main className="flex min-h-screen items-center justify-center bg-black px-6">

flex active le flexbox, c'est-à-dire une disposition où les enfants d'un élément se rangent en ligne. items-center les centre à la verticale, et justify-center à l'horizontale. min-h-screen donne une hauteur d'au moins tout l'écran, sans elle le centrage vertical ne se verrait pas. bg-black est le fond noir, et px-6 laisse un espace par rapport au bord du téléphone. Aucune de ces classes ne change la couleur du texte : ce sont les classes du titre et de la description qui s'en chargent.

À l'intérieur se trouve un <div> avec les classes max-w-xl text-center, qui limite la largeur du contenu et centre le texte. Dedans, le titre et la description :

<h1 className="text-4xl font-bold text-red-600 md:text-6xl">
  Kraken&apos;s Call
</h1>
<p className="mt-4 text-lg text-gray-300">
  Un jeu de pirates dans le navigateur : réunis un équipage et affronte le kraken.
</p>

text-4xl est la taille du titre, et md:text-6xl l'agrandit sur les écrans plus larges, nous y venons dans un instant. font-bold met en gras, text-red-600 colore en rouge, mt-4 ajoute 16 pixels d'espace au-dessus de la description, et text-gray-300 donne un texte gris clair sur le fond noir. &apos; est l'apostrophe écrite en JSX : sur la page, elle ressemble à un caractère ' ordinaire, mais le linter ne la signale pas.

À la fin, le bouton, la plus longue suite du fichier :

<button className="mt-8 rounded-lg bg-yellow-500 px-6 py-3 font-semibold text-black transition-colors hover:bg-yellow-600">
  Rejoindre l&apos;équipage
</button>

mt-8 éloigne le bouton de 32 pixels de la description, px-6 et py-3 donnent 24 pixels d'espace sur les côtés et 12 en haut et en bas, rounded-lg arrondit les coins, font-semibold met l'inscription en demi-gras, et text-black sur bg-yellow-500 donne un texte noir sur fond doré. hover:bg-yellow-600 assombrit le fond quand le curseur passe dessus, et transition-colors le fait en douceur. Pour l'instant, le bouton ne fait rien : il recevra son action plus tard.

Aide-mémoire pour lire les classes

Les classes de Tailwind se rangent en familles. Quand tu tombes dans le code de Claude sur une classe inconnue, cherche sa famille :

  • Couleurs : bg- est le fond, text- le texte, border- la bordure, par exemple bg-red-600, text-white, bg-black. Les nuances sont numérotées de 50 (la plus claire) à 950 (la plus foncée), donc hover:bg-red-700 avec bg-red-600 signifie un fond plus foncé au survol.
  • Espacements : p- est le padding, c'est-à-dire l'espace intérieur, et m- la marge, c'est-à-dire l'espace extérieur. L'unité vaut 4 pixels : p-1 fait 4px, p-2 8px, p-4 16px, p-8 32px. La lettre après p ou m choisit les côtés : px gauche et droite, py haut et bas, pt haut, pr droite, mt-8 marge du haut de 32px. mx-auto met une marge automatique sur les côtés et centre un bloc de largeur limitée.
  • Texte : les tailles, de la plus petite, sont text-xs, text-sm, text-base (16px), text-lg, text-xl, puis text-2xl et plus. L'épaisseur, de la plus fine : font-light, font-normal, font-medium, font-semibold, font-bold. L'alignement : text-left, text-center, text-right.
  • Disposition : block, inline, flex et grid choisissent le mode d'affichage, et hidden cache un élément (display: none). Dans un flexbox, flex-row est la direction horizontale (par défaut), flex-col la verticale, et gap-4 met 16 pixels d'espace entre les enfants.
  • Dimensions : w-full est une largeur de 100%, w-1/2 la moitié, max-w-md une largeur maximale de 448px. h-screen est une hauteur d'exactement tout l'écran (100vh), et min-h-screen d'au moins tout l'écran.
  • Bordures et coins : border est une bordure de 1px, border-2 de 2px, border-red-500 sa couleur. rounded arrondit de 4px (dans Tailwind 4, la même valeur porte aussi le nom rounded-sm), rounded-lg plus fort, et rounded-full au maximum : le bouton devient une pilule, et le carré un cercle.

N'apprends pas cette liste par cœur. Lis avec elle le code de Claude, et après quelques sections, les familles se reconnaîtront d'elles-mêmes.

Responsivité : le téléphone d'abord

On conçoit Tailwind à partir du plus petit écran, c'est-à-dire mobile first. Une classe sans préfixe agit toujours, et une classe avec un préfixe de breakpoint n'agit qu'à partir de la largeur d'écran indiquée :

  • sm: à partir de 640px ;
  • md: à partir de 768px, par exemple une tablette en portrait ;
  • lg: à partir de 1024px, un petit portable ;
  • xl: à partir de 1280px, un moniteur ;
  • 2xl: à partir de 1536px, un grand moniteur.

Dans le titre, Claude a écrit text-4xl md:text-6xl : sur un téléphone, le titre a la taille 4xl, et à partir de 768px, la taille 6xl. Tu verras le même schéma dans les dispositions de cartes :

<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">

Sur un téléphone, les cartes sont dans une seule colonne, à partir de 768px dans deux, et à partir de 1024px dans trois. Change la largeur de l'aperçu dans l'éditeur ci-dessous et regarde comment changent le nombre de colonnes et la taille du texte :

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>Responsivité Tailwind</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-gray-100 p-8">
    <h1 class="text-3xl font-bold mb-8 text-center">
        La responsivité dans Tailwind
    </h1>

    <!-- Mobile : 1 colonne, Tablette : 2 colonnes, Bureau : 3 colonnes -->
    <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
        <div class="bg-blue-500 text-white p-6 rounded-lg">
            <h2 class="text-xl font-bold mb-2">Carte 1</h2>
            <p>Redimensionne la fenêtre pour voir la responsivité !</p>
        </div>
        <div class="bg-purple-500 text-white p-6 rounded-lg">
            <h2 class="text-xl font-bold mb-2">Carte 2</h2>
            <p>Mobile : 1 colonne<br>Tablette (md) : 2 colonnes<br>Bureau (lg) : 3 colonnes</p>
        </div>
        <div class="bg-pink-500 text-white p-6 rounded-lg">
            <h2 class="text-xl font-bold mb-2">Carte 3</h2>
            <p>Breakpoints :<br>sm: 640px<br>md: 768px<br>lg: 1024px</p>
        </div>
    </div>

    <!-- Texte responsive -->
    <div class="mt-8 bg-white p-6 rounded-lg shadow">
        <p class="text-sm md:text-base lg:text-lg xl:text-xl">
            Ce texte a différentes tailles :<br>
            Mobile : text-sm (14px)<br>
            Tablette : text-base (16px)<br>
            Ordinateur portable : text-lg (18px)<br>
            Bureau : text-xl (20px)
        </p>
    </div>
</body>
</html>

Le dernier préfixe que tu rencontreras dans le code de Claude est dark:. Une classe qui le porte n'agit que si le système de l'utilisateur a le mode sombre activé :

<div class="bg-white text-black dark:bg-gray-900 dark:text-white">Carte au trésor</div>

En mode clair, le div a un fond blanc et un texte noir, et en mode sombre, un fond gris foncé et un texte blanc. Par défaut, Tailwind le vérifie à l'aide du réglage du système (prefers-color-scheme), et la page de démarrage de l'assistant utilise ce préfixe à de nombreux endroits, par exemple dark:bg-black.

Où Tailwind se trouve dans le projet

Dans un nouveau projet, Tailwind fonctionne dès la première minute : l'assistant avec l'option --tailwind a tout configuré, et tu n'as rien à installer en plus. Dans Tailwind 4, la configuration vit dans le CSS. La première ligne du fichier app/globals.css est :

@import "tailwindcss";

Cette seule ligne charge tout Tailwind. Plus bas dans ce fichier se trouve un bloc @theme inline, où le projet règle ses propres couleurs et polices. Tailwind est branché sur la construction par la règle de Turbopack dans next.config.ts, que tu as lue dans la leçon précédente.

Dans le projet, il n'y a ni fichier tailwind.config.js ni postcss.config.mjs. Les directives @tailwind base, @tailwind components et @tailwind utilities ainsi que le fichier tailwind.config.js sont la syntaxe de la version 3, et Tailwind 4 ne détecte plus un tel fichier tout seul. Si Claude te propose l'un d'eux, il écrit de mémoire sur l'ancienne version.

La revue du capitaine

Avant d'approuver le changement, vérifie dans le diff et dans le navigateur :

  1. La syntaxe de la version 4. Dans le code, il n'y a pas de classes supprimées dans Tailwind 4, comme bg-opacity-50 (aujourd'hui bg-black/50), flex-grow-* (aujourd'hui grow-*) ou overflow-ellipsis (aujourd'hui text-ellipsis), ni de nouveau fichier tailwind.config.js.
  2. L'écran étroit. Rétrécis la fenêtre du navigateur à la largeur d'un téléphone : le titre doit tenir, et le texte ne doit pas toucher les bords.
  3. La lisibilité. Le texte se détache nettement du fond : la description gris clair sur fond noir et l'inscription noire sur le bouton doré, tu les lis sans effort.
  4. Le survol est un bonus. Dans Tailwind 4, hover: n'agit que sur les appareils qui ont un curseur, donc sur un téléphone, le bouton ne s'assombrira pas. Aucune information importante ne peut apparaître uniquement au survol.

Erreur typique de l'agent : il mélange la syntaxe de Tailwind 3 et de Tailwind 4, ou, malgré l'interdiction, ajoute son propre fichier CSS. Une autre, fréquente en JSX : une apostrophe nue dans « Kraken's Call ». npm run build la laisse passer, mais npm run lint signale l'erreur react/no-unescaped-entities. C'est pourquoi la demande contenait les deux vérifications.

Étape suivante

Une correction par demande. Demande par exemple : « Dans @app/page.tsx, agrandis l'espace entre la description et le bouton, rien d'autre ». Dans le diff, une seule classe doit changer, mt-8 en une plus grande, par exemple mt-12. Quand le diff te convient, demande un commit. Dans l'éditeur ci-dessous t'attend la même section en HTML ordinaire : change les classes et regarde ce que fait chaque voile.

Retiens : une classe Tailwind est un ordre pour une seule voile ; lis-les une par une, et tu verras tout le navire.

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 - section hero</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>
    <!-- La même section que Claude a écrite dans app/page.tsx. En HTML, on écrit class au lieu de className -->
    <main class="flex min-h-screen items-center justify-center bg-black 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>
            <!-- Essaie : remplace mt-8 par mt-12, bg-yellow-500 par bg-red-600 et hover:bg-yellow-600 par hover:bg-red-700 -->
        </div>
    </main>
</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. Qu'est-ce que Tailwind CSS ?

  2. 2. Quelle classe Tailwind définit un arrière-plan rouge ?

  3. 3. Quel préfixe Tailwind applique un style à partir d'une largeur d'écran de 768px ?

  4. 4. Quelle classe Tailwind centre horizontalement les éléments dans un flexbox ?

  5. 5. Que fait la classe hover:bg-red-700 dans Tailwind ?

  6. 6. Quelle classe Tailwind définit la largeur de l'élément à 100% ?

  7. 7. Que dois-tu faire pour utiliser Tailwind dans Next.js si tu as choisi Tailwind CSS (ou les réglages recommandés) en créant le projet ?

  8. 8. Que fait le préfixe dark: dans une classe Tailwind (par exemple dark:bg-gray-900) ?

  9. 9. Quelle classe Tailwind définit la hauteur sur tout l'écran (100vh) ?

  10. 10. Quelle classe Tailwind centre un bloc à l'aide de marges gauche et droite automatiques ?

  11. 11. Quelle classe Tailwind cache un élément (display: none) ?

Tâches pratiques dans le jeu

  • Éditeur de code

    Crée un div avec un arrière-plan noir (bg-black), un texte blanc (text-white) et un padding de 16px (p-4). Mets-y n'importe quel texte.

  • Clique dans l'ordre

    Construis la classe Tailwind qui définit un texte blanc :

  • Tri vertical

    Ordonne les classes de padding Tailwind de la plus petite à la plus grande :

  • Éditeur de code

    Crée un div avec les classes flex, items-center, justify-center et h-screen, et place à l'intérieur un élément avec du texte, par exemple <p>. L'élément doit se placer au milieu de l'écran, verticalement et horizontalement.

  • Tri vertical

    Ordonne les points de rupture (breakpoints) Tailwind du plus petit écran au plus grand :

  • Tri horizontal

    Ordonne le code d'un bouton rouge Tailwind (de gauche à droite) :

  • Éditeur de code

    Construis un bouton de pirate <button> : arrière-plan rouge (par exemple bg-red-600), texte blanc (text-white), padding (par exemple px-6 py-3), coins arrondis (par exemple rounded-lg) et un arrière-plan plus foncé au survol de la souris (par exemple hover:bg-red-700).

  • Clique dans l'ordre

    Construis la classe Tailwind qui arrondit les coins avec un rayon plus grand :

  • Tri horizontal

    Ordonne les parties de la classe Tailwind pour un arrière-plan rouge (de gauche à droite) :

  • Tri vertical

    Ordonne les classes de graisse de police Tailwind de la plus fine à la plus grasse :

  • Tri vertical

    Ordonne les classes de taille de texte Tailwind de la plus petite à la plus grande :

  • Tri vertical

    Ordonne les classes nécessaires pour centrer un élément verticalement et horizontalement avec Tailwind :

  • Tri horizontal

    Ordonne les parties de la classe Tailwind pour une marge supérieure de 32px (de gauche à droite) :

  • Tri vertical

    Range dans le bon ordre les étapes pour changer l'apparence de la page avec Claude Code :

  • Clique dans l'ordre

    Construis la classe Tailwind pour un texte extra-large :

  • Clique dans l'ordre

    Construis la classe Tailwind qui définit la direction verticale du flexbox :

  1. QuestionQuiz : Tailwind CSS
  2. QuestionQuiz : les couleurs Tailwind
  3. Exercice de codePratique : le padding Tailwind
  4. QuestionQuiz : le responsive Tailwind
  5. Clique dans l'ordreOrdre : la classe pour un texte blanc
  6. Remets dans l'ordreOrdre : l'échelle du padding Tailwind
  7. Exercice de codePratique : le flexbox Tailwind
  8. QuestionQuiz : le flexbox Tailwind
  9. Remets dans l'ordreOrdre : les classes responsives Tailwind
  10. Remets dans l'ordreOrdre : construire un bouton Tailwind
  11. Exercice de codePratique : le bouton de pirate
  12. QuestionQuiz : le hover Tailwind
  13. Clique dans l'ordreOrdre : la classe des coins arrondis
  14. QuestionQuiz : la largeur Tailwind
  15. Remets dans l'ordreOrdre : la classe d'arrière-plan rouge
  16. Remets dans l'ordreOrdre : la graisse de police Tailwind
  17. Remets dans l'ordreOrdre : les tailles de texte Tailwind
  18. QuestionQuiz : Next.js + Tailwind
  19. Remets dans l'ordreOrdre : les classes de centrage flexbox
  20. QuestionQuiz : le mode sombre Tailwind
  21. Remets dans l'ordreOrdre : la classe de marge Tailwind
  22. QuestionQuiz : la hauteur d'écran Tailwind
  23. Remets dans l'ordreOrdre : le style avec Claude Code
  24. QuestionQuiz : le centrage par marge Tailwind
  25. Clique dans l'ordreOrdre : la classe complète de taille de texte
  26. QuestionQuiz : les classes display Tailwind
  27. Clique dans l'ordreOrdre : la direction verticale du flexbox

Articles utiles