Cours Vibe coding avec Claude Code · Module 4: Clone d'Instagram
Les photos du coffre : le composant Image de Next.js
Dans cette leçon11
Ahoy ! Nouvelle escale, nouveau clone : Treasure Gallery, une galerie de photos de la traversée à la manière d'Instagram. Tu commences par les photos seules, car ce sont elles qui pèsent le plus lourd dans une galerie. Claude Code va les afficher avec un composant qui s'occupe de la taille, du format et de l'ordre de chargement, et toi, tu vérifieras dans Cursor s'il a bien fait le travail.
Ce que tu vas apprendre
- demander à Claude Code une page avec des photos du dossier du projet et d'un serveur distant ;
- lire les props
width,height,fill,sizesetloadingdu composantImage; - vérifier dans
next.config.tsque la liste des serveurs de photos autorisés est étroite ; - repérer trois erreurs typiques de l'agent : un simple
<img>,fillsansrelativeet unaltqui ne dit rien.
Nouveau port : le projet treasure-gallery
Kraken's Call reste dans son port. C'est un jeu avec une messagerie, alors qu'Instagram est une autre application avec d'autres données : elle reçoit donc son propre projet. Tu le crées comme dans la leçon 1_2 : ouvre le dossier projets dans Cursor, lance claude et demande le projet avec la même demande que dans la leçon 1_2, en changeant seulement le nom en treasure-gallery. Avant de cliquer sur Yes, compare la commande à celle-ci :
npx create-next-app@latest treasure-gallery --ts --eslint --tailwind --app --no-src-dir --no-cache-components --agents-md --no-agent-feedback --use-npmTu connais les options depuis la leçon 1_2 : TypeScript, ESLint, Tailwind CSS et App Router, sans dossier src/ et sans Cache Components. Ensuite, la boucle de l'escale 2 : déplace la session dans le dossier treasure-gallery, demande npm run build comme preuve, crée un court CLAUDE.md avec l'import @AGENTS.md comme dans la leçon 1_7 et enregistre un commit. À partir de maintenant, chaque demande de cette escale concerne ce projet.
Le problème : une photo de téléphone pèse des mégaoctets
Crée dans le projet un dossier public/images/ et dépose-y trois de tes photos, par exemple prises avec ton téléphone, sous les noms skarb-1.jpg, skarb-2.jpg et skarb-3.jpg. La quatrième, kapitan.jpg, servira d'avatar. Une photo de téléphone fait en général plusieurs milliers de pixels de large et pèse des mégaoctets, alors que la vignette de la galerie occupe environ 300 pixels à l'écran. Une simple balise <img> enverra pourtant tout le fichier au navigateur. La page se charge lentement, elle avale les données mobiles, et quand les photos arrivent l'une après l'autre, le texte en dessous saute vers le bas.
Image en un paragraphe
Next.js a pour cela le composant Image du paquet next/image, qui étend la balise <img> ordinaire. Il prépare une copie de la photo à la taille dont l'écran a besoin, dans un format plus léger, WebP. Il charge les photos plus bas dans la page en différé (lazy loading), c'est-à-dire seulement quand elles approchent de la partie visible de l'écran. Il réserve aussi la place de l'image avant son arrivée, donc rien ne saute ; ce saut a un nom : Cumulative Layout Shift, abrégé CLS. En échange, Image veut savoir ce qu'il y a sur la photo (alt) et quelle taille l'image doit avoir (width et height, ou fill). Les photos venant de serveurs étrangers ne passent que si elles figurent dans la liste de next.config.ts.
Demande pour Claude Code
La galerie a deux sources de photos : ton dossier public/images/ et trois photos du service gratuit Unsplash. La demande contient un objectif, des fichiers, des contraintes et une vérification, comme dans la leçon 0_5 :
Demande pour Claude Code :
Construis la page /gallery de Treasure Gallery, un profil comme sur Instagram.
Garde les données des photos dans lib/photos.ts : id, src, alt, auteur et légende.
Trois photos sont dans public/images/ (skarb-1.jpg, skarb-2.jpg,
skarb-3.jpg) : regarde-les et écris un alt qui dit ce qu'on y voit.
Trois autres viennent d'Unsplash :
https://images.unsplash.com/photo-1507525428034-b723cf961d3e
https://images.unsplash.com/photo-1505118380757-91f5f5632de0
https://images.unsplash.com/photo-1534447677768-be436bb09401
En haut, un avatar rond tiré de public/images/kapitan.jpg (96 px) et un titre,
dessous des vignettes carrées sur trois colonnes. Partout Image
de next/image, nulle part <img>. Dans @next.config.ts autorise uniquement le serveur
images.unsplash.com et ne change rien d'autre dans ce fichier.
À la fin, lance npm run build et npm run lint et montre les résultats.La demande "regarde-les" n'est pas un ornement : Claude Code lit les fichiers PNG, JPEG, GIF et WebP comme des images, donc il verra lui-même ce qu'il y a sur tes photos. L'interdiction de toucher au reste de next.config.ts protège le reste du fichier, y compris la règle que l'assistant de création y a écrite pour Tailwind.
Ce que Claude a écrit : les données des photos
Ouvre lib/photos.ts dans Cursor. En haut, le type d'une photo, dessous un tableau de six entrées. Voici deux d'entre elles, une distante et une locale :
export interface Photo {
id: string;
src: string;
alt: string;
author: string;
caption: string;
}
export const photos: Photo[] = [
{
id: "coucher-plage",
src: "https://images.unsplash.com/photo-1507525428034-b723cf961d3e",
alt: "Vagues sur une plage de sable au coucher du soleil",
author: "Morgan",
caption: "Ici, nous avons enterré le coffre",
},
{
id: "skarb-1",
src: "/images/skarb-1.jpg",
alt: "Palmiers et parasol de paille sur une plage blanche",
author: "Capitaine Barbe-Rousse",
caption: "L'île de la carte",
},
];Le src d'une photo du dossier public/ commence par une barre oblique et ne contient pas le mot public : le fichier public/images/skarb-1.jpg est disponible à l'adresse /images/skarb-1.jpg. Une photo distante a une adresse complète avec https://. Tes descriptions alt seront différentes, car Claude les a écrites en regardant tes photos.
L'avatar : width et height
Ouvre app/gallery/page.tsx. En haut, l'import du composant : import Image from "next/image";. La page est un <main> avec la classe max-w-4xl, donc elle fait au plus 896 pixels de large. Elle commence par un en-tête de profil avec l'avatar :
<Image
src="/images/kapitan.jpg"
alt="Portrait du capitaine Barbe-Rousse"
width={96}
height={96}
className="h-24 w-24 rounded-full object-cover"
/>width et height sont les dimensions de l'image en pixels. Next.js en déduit les proportions et réserve la place avant l'arrivée du fichier, et il choisit aussi la taille de la copie d'après elles. La taille à l'écran vient des classes : h-24 w-24 donne 96 sur 96 pixels, rounded-full fait un cercle, et object-cover rogne une photo qui n'est pas carrée. Les deux props sont obligatoires, sauf si l'image a fill ou si elle est importée depuis un fichier avec l'instruction import.
Les vignettes : fill, sizes et loading
Sous l'en-tête se trouve la grille. Chaque vignette est une boîte carrée avec une image à l'intérieur :
<div className="grid grid-cols-3 gap-1">
{photos.map((photo, index) => (
<div key={photo.id} className="relative aspect-square">
<Image
src={photo.src}
alt={photo.alt}
fill
sizes="(max-width: 896px) 33vw, 300px"
loading={index < 3 ? "eager" : "lazy"}
className="object-cover"
/>
</div>
))}
</div>Nous ne connaissons pas les dimensions des photos de téléphone et d'Unsplash, donc Claude a utilisé fill : l'image s'étire sur toute la boîte parente. Le parent doit avoir une position relative, absolute ou fixed, ici la classe relative, et une hauteur, que donne aspect-square, un carré de proportions 1:1. object-cover remplit le carré et rogne ce qui dépasse, alors que object-contain montrerait toute la photo avec des bandes vides.
sizes dit au navigateur quelle sera la largeur de l'image : dans une fenêtre jusqu'à 896 pixels, un tiers de la largeur de l'écran (33vw), dans une fenêtre plus large 300 pixels. Sans sizes, le navigateur suppose qu'une image avec fill occupe tout l'écran et télécharge un fichier trop gros. loading décide quand charger. Par défaut, l'image se charge en différé, et Claude a réglé la première rangée, visible dès l'arrivée, sur "eager", c'est-à-dire tout de suite.
L'ancienne prop priority est obsolète depuis Next.js 16, et la documentation recommande dans la plupart des cas loading="eager" ou fetchPriority="high" à la place (état en novembre 2026). La page d'accueil générée par l'assistant utilise encore priority sur le logo Next.js, ne la prends donc pas pour modèle.
next.config.ts : la liste des serveurs autorisés
Ouvre next.config.ts. Le bloc turbopack avec la règle pour Tailwind a été laissé par l'assistant de création, et Claude n'a ajouté dessous que images :
import type { NextConfig } from "next";
const nextConfig: NextConfig = {
/* config options here */
turbopack: {
rules: {
"*.css": {
loaders: ["@tailwindcss/turbopack"],
as: "*.css",
},
},
},
images: {
remotePatterns: [
{
protocol: "https",
hostname: "images.unsplash.com",
port: "",
pathname: "/**",
search: "",
},
],
},
};
export default nextConfig;remotePatterns est une liste de modèles d'adresses depuis lesquelles Next.js peut télécharger et transformer des images. Cette entrée ne laisse passer que https, que le serveur images.unsplash.com, sans autres ports (port: "") et sans paramètres après le point d'interrogation (search: ""). /** dans pathname signifie n'importe quel chemin sur ce serveur. La documentation montre aussi une écriture plus courte avec une seule adresse : remotePatterns: [new URL("https://images.unsplash.com/**")]. Le serveur npm run dev remarque seul le changement de ce fichier et affiche "Found a change in next.config.ts. Restarting the server", tu n'as donc pas besoin de le redémarrer. Une photo d'un serveur hors de la liste arrête la page avec cette erreur :
Error: Invalid src prop (https://example.com/a.jpg) on `next/image`, hostname "example.com" is not configured under images in your `next.config.js`Le message parle de next.config.js, mais dans un projet TypeScript il s'agit du même fichier sous la forme next.config.ts. La correction est une nouvelle entrée dans la liste, toujours avec un serveur précis.
La revue du capitaine
Lance npm run dev dans un deuxième terminal, ouvre localhost:3000/gallery et vérifie :
- Aucun
<img>. Cherche le texte<imgdans le projet : il ne doit y avoir aucun résultat dansapp/. Une balise ordinaire n'interrompt pas le build, et le linter ne fait qu'avertir :
warning Using `<img>` could result in slower LCP and higher bandwidth. Consider using `<Image />` from `next/image` ... @next/next/no-img-elementL'avertissement ne transforme pas le résultat de npm run lint en erreur, c'est pourquoi tu lis la sortie de la commande et pas seulement si elle s'est terminée.
fillsansrelative. C'est une erreur typique de l'agent : Claude ajoutefill, mais la boîte au-dessus de l'image n'a pas de position. La photo se répand alors sur toute la page, et la console du navigateur affiche :
Image with src "/images/skarb-1.jpg" has "fill" and parent element with invalid "position". Provided "static" should be one of absolute,fixed,relative.La correction est la classe relative sur le parent, et non la suppression de fill.
Une liste de serveurs étroite. Dans
next.config.ts, il n'y a nihostname: "**"ni entrée sansprotocol. La documentation prévient que les champs omis agissent comme une étoile et laissent passer des adresses que tu n'avais pas prévues. Le blocturbopackest resté intact.altdécrit la photo. "Image", "photo 1" ou le nom du fichier ne disent rien à une personne dont le lecteur d'écran lit la page à voix haute. Un bonaltremplace la photo par des mots. Pour une image purement décorative, la documentation demande unalt=""vide.
Enfin, la preuve que l'optimisation fonctionne : fais un clic droit sur une vignette et ouvre l'image dans un nouvel onglet. L'adresse commence par /_next/image?url= et comporte un paramètre w, c'est-à-dire la largeur de la copie. Lors de notre essai, une photo de 1,5 Mo est arrivée en copie de 384 pixels de large, en fichier WebP d'environ 21 Ko.
Étape suivante
Quand la revue est passée, demande un commit, par exemple "Galerie : photos via next/image et liste des serveurs". Avant la prochaine leçon, fais encore une chose, loin de l'ordinateur : dessine sur une feuille l'aspect de la galerie après un clic sur une photo. Une grille de vignettes, et au-dessus une fenêtre avec la grande photo, l'auteur, la légende et une croix pour fermer. Prends la feuille en photo avec ton téléphone, car dans la leçon 3_2 Claude Code construira la fenêtre à partir de ce croquis.
Dans l'éditeur ci-dessous, tu as des carreaux carrés avec de vraies photos. L'éditeur n'a pas de serveur Next.js, donc il contient un simple <img> avec les classes que Image avec fill reçoit dans le projet. Passe de object-cover à object-contain et regarde où disparaît le rognage, puis fais les exercices.
À retenir : tu montres le trésor à la taille qui tient dans la longue-vue, pas le coffre entier, et tu ne laisses entrer que les ports que tu as toi-même inscrits sur la liste.
Code de cette leçon : App.jsx
// Vignettes de la galerie : object-cover contre object-contain
// Dans le projet Next.js, on écrit ici <Image fill className="object-cover" />.
// L'éditeur n'a pas de serveur Next.js, donc un simple <img> reçoit les classes
// que Image avec fill applique tout seul : absolute, pleine largeur et pleine hauteur.
import { useState } from 'react';
const photos = [
{
id: 'coucher-plage',
src: 'https://images.unsplash.com/photo-1507525428034-b723cf961d3e?w=600',
alt: 'Vagues sur une plage de sable au coucher du soleil',
},
{
id: 'vagues-ciel',
src: 'https://images.unsplash.com/photo-1505118380757-91f5f5632de0?w=600',
alt: 'Vagues turquoise sur une plage blanche vues du ciel',
},
{
id: 'voilier-nuit',
src: 'https://images.unsplash.com/photo-1534447677768-be436bb09401?w=600',
alt: 'Petit voilier sur une mer calme sous un ciel étoilé',
},
];
const fits = ['object-cover', 'object-contain'];
export default function App() {
const [fit, setFit] = useState('object-cover');
return (
<div className="min-h-screen bg-slate-100 p-6 text-slate-900">
<h1 className="mb-1 text-2xl font-bold">Treasure Gallery</h1>
<p className="mb-4 text-sm text-slate-600">
La vignette a relative et aspect-square, et la photo la remplit entièrement.
</p>
<div className="mb-4 flex gap-2">
{fits.map((option) => (
<button
key={option}
type="button"
onClick={() => setFit(option)}
aria-pressed={fit === option}
className={fit === option
? 'rounded bg-slate-900 px-3 py-1 text-sm text-white'
: 'rounded bg-white px-3 py-1 text-sm'}
>
{option}
</button>
))}
</div>
<div className="grid grid-cols-3 gap-1">
{photos.map((photo) => (
<div key={photo.id} className="relative aspect-square bg-slate-800">
<img
src={photo.src}
alt={photo.alt}
className={`absolute inset-0 h-full w-full ${fit}`}
/>
</div>
))}
</div>
<p className="mt-4 text-sm text-slate-600">
{fit === 'object-cover'
? 'object-cover : le carré est plein, les bords de la photo sont rognés.'
: 'object-contain : toute la photo est visible, avec des bandes vides sur les bords.'}
</p>
</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'apporte le composant Image de next/image par rapport à une simple balise <img> ?
2. Dans quel format Next.js envoie-t-il par défaut la copie optimisée d'une photo à un navigateur qui gère ce format ?
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 dans l'ordre pour importer le composant Image depuis Next.js :
- Tri horizontal
Ordonne les fragments de l'écriture courte de la liste des serveurs de photos autorisés dans next.config.ts (une seule ligne, depuis la gauche) :
- Éditeur de code
Composant Image
- Clique dans l'ordre
Clique sur les fragments dans l'ordre pour que les trois premières vignettes se chargent tout de suite et les autres en différé :
- Tri vertical
Ordonne les lignes du fichier next.config.ts avec la liste des serveurs de photos autorisés (de haut en bas) :
- Éditeur de code
Image responsive
- Tri horizontal
Le fichier se trouve dans public/images/tresors/tresor-1.jpg. Ordonne les fragments de la valeur src que tu écriras dans Image :
Exercices après cette leçon
- QuestionQuiz : Image au lieu de img
- QuestionQuiz : le format de la photo optimisée
- QuestionQuiz : les props obligatoires de l'image
- Clique dans l'ordreClic dans l'ordre : importer le composant Image
- Remets dans l'ordreTri : l'écriture courte de remotePatterns
- Exercice de codePratique : Image de base
- QuestionQuiz : la prop fill
- QuestionQuiz : object-cover et object-contain
- Clique dans l'ordreClic dans l'ordre : quand charger les vignettes
- Remets dans l'ordreTri : le fichier next.config.ts
- Exercice de codePratique : Image avec fill
- QuestionQuiz : les photos visibles tout de suite
- QuestionQuiz : les photos de serveurs distants
- Remets dans l'ordreTri : le chemin d'une photo de public