Que fait Images de partage social et icônes ?
Lorsque quelqu'un colle le lien du site dans X, LinkedIn, Slack, Discord ou WhatsApp, une grande image avec un titre lisible doit apparaître. Les navigateurs et les téléphones doivent afficher une icône nette.
1. Inspection
- Dossier App (
src/app/ouapp/), fichiers existantsfavicon.ico,icon.*,apple-icon.*,opengraph-image.*,twitter-image.*. metadataBasedans la mise en page racine. Sans cela, les URL og:image sont relatives et les plateformes sociales les ignorent. S'il manque, ajoutez-le (voir la compétencelaunch-seo, ou définissezmetadataBase: new URL("https://votre-domaine.com")).next.config.*:output: "export"?- Marque : nom, slogan, couleur primaire, logo (SVG de préférence). Réutilisez les tokens de
globals.css. - Lisez la documentation correspondant à la version :
node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.mdnode_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.mdnode_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md
2. Image Open Graph (site-wide)
Copiez assets/opengraph-image.tsx vers app/opengraph-image.tsx et modifiez les valeurs de la marque. Il exporte alt, size (1200×630) et contentType, et dessine l'image avec ImageResponse de next/og.
Règles de conception pour les images de partage :
- Titre de 3 à 8 mots, au moins 64 px, contraste élevé. Il doit être lisible sous forme de vignette de 300 px de large.
- Conservez le contenu important dans la zone centrale de 1000×500 ; certaines plateformes rognent les bords.
- Marque + nom de domaine dans un coin pour que les gens sachent où mène le lien.
- Flexbox uniquement :
ImageResponseprend en charge un sous-ensemble de CSS (display: flex, pas de grille). Chaque élément avec plus d'un enfant nécessitedisplay: "flex". - Polices : la police par défaut fonctionne immédiatement. Pour une police personnalisée, chargez un fichier
.ttf/.otf/.woff(pas.woff2) avecreadFileet passez-le dans l'optionfonts, comme indiqué dans la documentation. - Limite de taille : 8 Mo pour Open Graph, 5 Mo pour Twitter. Les PNG générés font généralement moins de 100 Ko.
twitter-image est optionnel : lorsqu'il est manquant, X utilise l'image Open Graph. Assurez-vous que les métadonnées racine définissent twitter: { card: "summary_large_image" }.
3. Images par page (articles de blog, documentation, pages produit)
Ajoutez opengraph-image.tsx à l'intérieur du segment dynamique, par exemple app/blog/[slug]/opengraph-image.tsx. Il reçoit params (une Promise) et peut charger le titre de l'article ; exportez generateStaticParams depuis le fichier image pour que chaque image soit pré-rendue. Gardez le même modèle pour que tous les partages ressemblent à une seule marque.
Ceci est plus important qu'il n'y paraît : lorsqu'une page définit son propre openGraph dans metadata/generateMetadata, cela remplace l'objet openGraph parent, et l'image de partage racine disparaît de cette page. Un fichier opengraph-image au niveau du segment (ou un openGraph.images explicite) corrige cela.
4. Icônes
Fichier (dans app/) | Taille | Objectif |
|---|---|---|
favicon.ico | 32×32 (multi-taille ok) | Onglet du navigateur, requis à la racine de l'app |
icon.png ou icon.svg | 512×512 PNG ou SVG | Navigateurs modernes, Android |
apple-icon.png | 180×180 | Écran d'accueil iOS |
Vous pouvez également générer icon.tsx / apple-icon.tsx avec ImageResponse — voir assets/icon.tsx. Remplacez le favicon.ico par défaut de create-next-app avant le lancement ; si aucun outil .ico n'est disponible, un icon.png 32×32 et la suppression de l'ancien favicon.ico est acceptable.
5. Note sur l'export statique
Avec output: "export" (testé sur Next.js 16.4) :
cacheComponentsdoit être désactivé pour un export statique, et chaque fichier image généré (opengraph-image.tsx,icon.tsx,apple-icon.tsx) nécessiteexport const dynamic = "force-static";, sinon la build échoue. Les segments dynamiques ont également besoin degenerateStaticParams.- Les images générées sont exportées sans extension de fichier (
out/opengraph-image), donc les hôtes statiques les servent sans en-têteContent-Type(vérifié sur Cloudflare Pages). Certains robots rejettent cela. La meilleure solution pour l'image site-wide : ouvrez/opengraph-imagesur le site en cours d'exécution, enregistrez-le et commitez-le en tant queapp/opengraph-image.png(puis supprimez le.tsx); il s'exporte en tant queopengraph-image.pngavec le bon type. Idem pour les icônes (app/icon.png,app/apple-icon.png). Pour les images par article, définissezContent-Type: image/pngpour ces chemins dans le fichier d'en-têtes de l'hôte (public/_headerssur Cloudflare Pages/Netlify).
6. Vérification
-
npm run builddoit réussir. La sortie de build liste les routesopengraph-image. -
Démarrez le site (
npm run start, ou servez le dossierout/) et exécutez le vérificateur (Node 18+, aucune dépendance).<skill-dir>est le dossier qui contient ce SKILL.md :node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/un-articleIl lit les balises
og:*ettwitter:*de la page, télécharge l'image et vérifie l'URL absolue, le statut HTTP, la taille du fichier, les dimensions (1200×630),og:image:altettwitter:card. Les URL localhost dans les balises sont signalées, car cela signifie quemetadataBaseest manquant ou incorrect pour la production. -
Ouvrez l'URL de l'image dans le navigateur et regardez-la. Vérifiez que le texte est lisible lorsque la fenêtre du navigateur est étroite.
-
Après le déploiement, dites à l'utilisateur de tester avec les outils des plateformes elles-mêmes (LinkedIn Post Inspector, Facebook Sharing Debugger). Ceux-ci actualisent également les aperçus mis en cache.
Rapport
Listez les fichiers image et icône créés, la sortie du vérificateur, et rappelez que les plateformes mettent en cache les aperçus : après avoir modifié l'image, ré-analysez avec les outils ci-dessus.