CommunityImagegithub.com

Images de partage social et icônes

Crée les images de partage et icônes nécessaires pour un site Next.js App Router — une image Open Graph 1200×630 générée avec next/og ImageResponse, les balises Twitter/X card, favicon, icônes d'appli et Apple touch icon, ainsi que des images OG par page pour les articles de blog — et les vérifie avec un script de contrôle.

Qu'est-ce que Images de partage social et icônes ?

Cette compétence automatise la création d'images de partage social et d'icônes pour les sites Next.js App Router, garantissant que les liens affichent des aperçus riches lorsqu'ils sont partagés sur X, LinkedIn, Slack, Discord ou WhatsApp. Elle génère une image Open Graph site-wide de 1200×630 pixels avec `next/og ImageResponse`, des images Twitter/X card, un favicon, des icônes d'appli (512×512) et une icône Apple touch (180×180). Elle crée également des images OG par page pour les segments dynamiques comme les articles de blog, en utilisant un modèle cohérent pour maintenir une identité de marque unifiée. La compétence prend en charge la configuration manuelle via des fichiers TSX dans le dossier `app/` et fournit des modèles prêts à l'emploi dans le répertoire `assets/`. Elle inclut une vérification automatisée avec un script Node.js qui valide les tailles, dimensions (1200×630), en-têtes HTTP et présence des balises `twitter:card`. Elle gère également des cas particuliers comme les sites utilisant `output: "export"`, où les images statiques peuvent nécessiter une attention particulière pour les en-têtes Content-Type. L'utilisateur reçoit un rapport final listant les fichiers créés et une recommandation de tester avec les outils de débogage des plateformes (comme LinkedIn Post Inspector ou Facebook Sharing Debugger) pour forcer le rafraîchissement du cache.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nandot12/nextjs-launch-skills/tree/main/skills/launch-social-images

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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/ ou app/), fichiers existants favicon.ico, icon.*, apple-icon.*, opengraph-image.*, twitter-image.*.
  • metadataBase dans 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étence launch-seo, ou définissez metadataBase: 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.md
    • node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.md
    • node_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 : ImageResponse prend en charge un sous-ensemble de CSS (display: flex, pas de grille). Chaque élément avec plus d'un enfant nécessite display: "flex".
  • Polices : la police par défaut fonctionne immédiatement. Pour une police personnalisée, chargez un fichier .ttf/.otf/.woff (pas .woff2) avec readFile et passez-le dans l'option fonts, 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/)TailleObjectif
favicon.ico32×32 (multi-taille ok)Onglet du navigateur, requis à la racine de l'app
icon.png ou icon.svg512×512 PNG ou SVGNavigateurs modernes, Android
apple-icon.png180×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) :

  • cacheComponents doit être désactivé pour un export statique, et chaque fichier image généré (opengraph-image.tsx, icon.tsx, apple-icon.tsx) nécessite export const dynamic = "force-static";, sinon la build échoue. Les segments dynamiques ont également besoin de generateStaticParams.
  • 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ête Content-Type (vérifié sur Cloudflare Pages). Certains robots rejettent cela. La meilleure solution pour l'image site-wide : ouvrez /opengraph-image sur le site en cours d'exécution, enregistrez-le et commitez-le en tant que app/opengraph-image.png (puis supprimez le .tsx); il s'exporte en tant que opengraph-image.png avec le bon type. Idem pour les icônes (app/icon.png, app/apple-icon.png). Pour les images par article, définissez Content-Type: image/png pour ces chemins dans le fichier d'en-têtes de l'hôte (public/_headers sur Cloudflare Pages/Netlify).

6. Vérification

  1. npm run build doit réussir. La sortie de build liste les routes opengraph-image.

  2. Démarrez le site (npm run start, ou servez le dossier out/) 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-article
    

    Il lit les balises og:* et twitter:* 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:alt et twitter:card. Les URL localhost dans les balises sont signalées, car cela signifie que metadataBase est manquant ou incorrect pour la production.

  3. 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.

  4. 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.

Skills associés