CommunityBildgithub.com

Social-Media-Bilder und Symbole erstellen

Erstellt die Share- und Icon-Bilder, die eine Next.js App Router-Website benötigt – ein 1200×630 Open Graph-Bild generiert mit next/og ImageResponse, Twitter/X-Karten-Tags, Favicon, App-Symbole und Apple Touch Icon, plus seitenbezogene OG-Bilder für Blogbeiträge – und verifiziert sie mit einem Prüfskript. Verwende dies, wenn der Benutzer OG-Bild, Social Preview, Link Preview, Share Card, Twitter Card, Favicon oder App Icon erwähnt, oder wenn Links zur Website auf X, LinkedIn, Slack, Discord oder WhatsApp kein Bild anzeigen.

Was ist Social-Media-Bilder und Symbole erstellen?

Dieser Skill automatisiert die Erstellung aller Social-Media- und Icon-Bilder für eine Next.js-App-Router-Website. Er generiert ein 1200×630 Open Graph-Bild mit `next/og` ImageResponse, Twitter/X-Karten-Tags, Favicon, App-Symbole und Apple Touch Icon. Zudem erstellt er seitenbezogene OG-Bilder für Blogbeiträge und statische Seiten, um sicherzustellen, dass jeder Teil der Website beim Teilen in sozialen Netzwerken wie X, LinkedIn, Slack, Discord oder WhatsApp ein ansprechendes Vorschaubild anzeigt. Der Skill bietet eine Schritt-für-Schritt-Anleitung zur Inspektion der bestehenden Struktur, Erstellung der Bilder und Symbole, Berücksichtigung von Static-Export-Besonderheiten und Verifikation der Ergebnisse mit einem Prüfskript. Er unterstützt Next.js-App-Router-Projekte und ist besonders nützlich, um die Sichtbarkeit und Attraktivität von Website-Links in sozialen Medien zu verbessern.

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

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Social-Media-Bilder und Symbole

Wenn jemand den Link der Website in X, LinkedIn, Slack, Discord oder WhatsApp einfügt, sollte ein großes Bild mit einer lesbaren Überschrift erscheinen. Browser und Mobilgeräte sollten ein scharfes Symbol anzeigen.

1. Überprüfung

  • App-Ordner (src/app/ oder app/), vorhandene favicon.ico, icon.*, apple-icon.*, opengraph-image.*, twitter-image.*.
  • metadataBase im Root-Layout. Ohne sie sind og:image-URLs relativ und Social-Media-Plattformen ignorieren sie. Wenn es fehlt, füge es hinzu (siehe den Skill launch-seo, oder setze metadataBase: new URL("https://your-domain.com")).
  • next.config.*: output: "export"?
  • Marke: Name, Slogan, Primärfarbe, Logo (SVG bevorzugt). Verwende Tokens aus globals.css wieder.
  • Lies die versionsabgestimmte Dokumentation:
    • 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. Open Graph-Bild (site-weit)

Kopiere assets/opengraph-image.tsx nach app/opengraph-image.tsx und bearbeite die Markenwerte. Es exportiert alt, size (1200×630) und contentType und zeichnet das Bild mit ImageResponse von next/og.

Designregeln für Teilen-Bilder:

  • Überschrift mit 3–8 Wörtern, mindestens 64 px, hoher Kontrast. Sie muss als 300 px breite Miniaturansicht lesbar sein.
  • Halte wichtige Inhalte innerhalb der zentralen 1000×500 Fläche; einige Plattformen beschneiden die Ränder.
  • Markenzeichen + Domainname in einer Ecke, damit die Leute wissen, wohin der Link führt.
  • Nur Flexbox: ImageResponse unterstützt eine Teilmenge von CSS (display: flex, kein Grid). Jedes Element mit mehr als einem Kind benötigt display: "flex".
  • Schriftarten: Die Standardschriftart funktioniert sofort. Für eine benutzerdefinierte Schriftart lade eine .ttf/.otf/.woff-Datei (nicht .woff2) mit readFile und übergib sie in der Option fonts, wie in der Dokumentation gezeigt.
  • Größenlimit: 8 MB für Open Graph, 5 MB für Twitter. Generierte PNGs sind normalerweise unter 100 KB.

twitter-image ist optional: Wenn es fehlt, verwendet X das Open Graph-Bild. Stelle sicher, dass die Root-Metadaten twitter: { card: "summary_large_image" } setzen.

3. Seitenbezogene Bilder (Blogbeiträge, Dokumentationen, Produktseiten)

Füge opengraph-image.tsx innerhalb des dynamischen Segments hinzu, z. B. app/blog/[slug]/opengraph-image.tsx. Es erhält params (ein Promise) und kann den Beitragstitel laden; exportiere generateStaticParams aus der Bilddatei, damit jedes Bild vorgerendert wird. Behalte dieselbe Vorlage bei, damit alle geteilten Inhalte wie eine Marke aussehen.

Dies ist wichtiger, als es scheint: Wenn eine Seite ihr eigenes openGraph in metadata/generateMetadata setzt, ersetzt es das openGraph-Objekt des übergeordneten Elements, und das Root-Share-Bild verschwindet von dieser Seite. Eine opengraph-image-Datei auf Segmentebene (oder ein explizites openGraph.images) behebt das.

4. Symbole

Datei (in app/)GrößeZweck
favicon.ico32×32 (multi-size ok)Browser-Tab, erforderlich im App-Root
icon.png oder icon.svg512×512 PNG oder SVGModerne Browser, Android
apple-icon.png180×180iOS-Startbildschirm

Du kannst auch icon.tsx / apple-icon.tsx mit ImageResponse generieren – siehe assets/icon.tsx. Ersetze das standardmäßige favicon.ico von create-next-app vor dem Start; wenn kein .ico-Tool verfügbar ist, ist ein 32×32 icon.png plus das Löschen des alten favicon.ico akzeptabel.

5. Hinweis zum statischen Export

Mit output: "export" (getestet auf Next.js 16.4):

  • cacheComponents muss für einen statischen Export deaktiviert sein, und jede generierte Bilddatei (opengraph-image.tsx, icon.tsx, apple-icon.tsx) benötigt export const dynamic = "force-static";, sonst schlägt der Build fehl. Dynamische Segmente benötigen außerdem generateStaticParams.
  • Generierte Bilder werden ohne Dateierweiterung exportiert (out/opengraph-image), sodass statische Hosts sie ohne einen Content-Type-Header ausliefern (getestet auf Cloudflare Pages). Einige Crawler lehnen das ab. Die beste Lösung für das site-weite Bild: Öffne /opengraph-image auf der laufenden Website, speichere es und committe es als app/opengraph-image.png (dann lösche die .tsx); es exportiert als opengraph-image.png mit dem richtigen Typ. Gleiches für Symbole (app/icon.png, app/apple-icon.png). Für beitragsbezogene Bilder setze Content-Type: image/png für diese Pfade in der Header-Datei des Hosts (public/_headers auf Cloudflare Pages/Netlify).

6. Verifizierung

  1. npm run build muss erfolgreich sein. Die Build-Ausgabe listet die opengraph-image-Routes auf.

  2. Starte die Website (npm run start, oder diene den out/-Ordner) und führe den Prüfer aus (Node 18+, keine Abhängigkeiten). <skill-dir> ist der Ordner, der diese SKILL.md enthält:

    node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-post
    

    Es liest die og:*- und twitter:*-Tags der Seite, lädt das Bild herunter und überprüft absolute URL, HTTP-Status, Dateigröße, Abmessungen (1200×630), og:image:alt und twitter:card. Lokale URLs in den Tags werden gemeldet, da dies bedeutet, dass metadataBase für die Produktion fehlt oder falsch ist.

  3. Öffne die Bild-URL im Browser und betrachte sie. Überprüfe, ob der Text lesbar ist, wenn das Browserfenster schmal ist.

  4. Nach dem Deployment sage dem Benutzer, er solle mit den eigenen Tools der Plattformen testen (LinkedIn Post Inspector, Facebook Sharing Debugger). Diese aktualisieren auch zwischengespeicherte Vorschauen.

Bericht

Liste die erstellten Bild- und Symboldateien, die Ausgabe des Prüfers und eine Erinnerung auf, dass Plattformen Vorschauen zwischenspeichern: Nach dem Ändern des Bildes sollte mit den obigen Tools erneut gescrapt werden.

Verwandte Skills