Images Og
Trois types d'images qui font toutes le même travail : faire en sorte que quelqu'un s'arrête sur un lien et comprenne l'application en un coup d'œil. Chacune est une capture réelle de l'application avec un titre large, sur le fond de la marque ou un papier peint lumineux. L'interface est le héros. Rien n'est dessiné à part le cadre.
Sorties, dans launch-assets/og/ du dépôt de l'utilisateur :
| Fichier | Taille | Description |
|---|---|---|
og.png | 1200×630 | L'aperçu de lien pour la page d'accueil. |
og-<id>.png | 1200×630 | Optionnel : un par page d'un site, même design, titre de cette page. |
ph/01-<id>.png … 06 | 1270×760 | Galerie Product Hunt, 4 à 6 diapositives. La diapositive 1 est le héros. |
x-header.png | 1500×500 | Bannière X avec l'avatar et les zones de recadrage téléphone dégagées. |
meta.html | Les balises <meta> à coller dans <head>. |
Les tailles et zones de sécurité, avec sources et dates, se trouvent dans references/sizes.md.
Quand l'utiliser
- Un lancement a besoin d'une image de partage, d'une galerie Product Hunt ou d'une bannière X.
- L'actuelle
og:imagedu site est un logo sur une couleur unie, ou il n'y en a pas. - Une version a changé l'interface, donc les aperçus sont re-rendus à partir de nouvelles captures.
Les captures sont des fenêtres ou îlots de style macOS en paysage ; un écran de téléphone en portrait n'est pas pris en charge par ces cartes. Pas pour : les captures d'écran App Store (un skill différent, avec des tailles différentes), ou tout ce qui nécessite une interface que l'application n'a pas. Ce skill ne dessine jamais d'interface.
Configuration (une fois)
Node 20 ou plus récent. Playwright va dans le dossier de ce skill, pas dans le dépôt de l'utilisateur :
npm install --prefix <skill-folder> [email protected] && npx --prefix <skill-folder> playwright install chromium
Si Playwright est manquant, render.mjs imprime cette ligne et se termine avec le code 2.
Étape 0. Marque
Lire launch-assets/brand.json dans le dépôt de l'utilisateur. S'il existe, l'utiliser. S'il est manquant, détecter chaque champ à partir du dépôt et écrire le fichier. Demander à l'utilisateur uniquement ce que vous n'avez pas trouvé, en un seul message.
{
"appName": "Halo", "oneLiner": "The Dynamic Island for Mac", "platform": "macos",
"colors": { "bg": "#f5f5f7", "ink": "#1d1d1f", "accent": "#0071e3" },
"fonts": { "family": "-apple-system, 'SF Pro Display', sans-serif", "file": null, "google": null },
"iconPath": "site/assets/icon.png",
"screenshotDirs": ["launch-assets/captures"],
"siteUrl": "https://example.com"
}
appName,oneLiner: titre et première ligne du README,<title>et<h1>du site,Info.plist.colors: les variables CSS du site, l'AccentColordu catalogue d'assets, les définitions SwiftColor. Prendre les valeurs light. Écrire en hexadécimal (#0d7f76) ; convertir d'abordrgb(),oklch()ethsl(). Tout ce que le rendu ne peut pas lire compte comme gris.fonts.family(une pile CSS),fonts.file(un fichier de police livré dans le dépôt, un chemin relatif à la racine du dépôt, le dossier au-dessus delaunch-assets, ounull),fonts.google(par exempleGeist:wght@400;600, ounull). Utiliser la police de la marque uniquement si le dépôt livre le fichier ; sinon la pile système ou Google Fonts. Ne jamais copier une police propriétaire dans le dépôt de l'utilisateur.iconPath: l'icône de l'application, un PNG carré (1024 px c'est le mieux), relatif à la racine du dépôt. Chercher dans les assets du site, l'AppIcondu catalogue d'assets, le dossier favicon. Requis : l'icône et le nom sont sur chaque image.siteUrl: oùmeta.htmlpointe les URLs des images. Optionnel ; sans lui les balises portent un placeholder.
Étapes
-
Captures. Réutiliser ce qui existe :
launch-assets/captures/,screenshotDirs, ou unlaunch-assets/store-screenshots/shots.jsonantérieur. En prendre de nouvelles seulement quand aucune ne passe les règles ci-dessous. Chercher d'abord la propre façon de l'application de se capturer elle-même : un flag snapshot, démo ou données d'exemple (rg -i "demo|snapshot|screenshot|marketing"dans le code source, le README etPackage.swift; par exempleMyApp --snapshot <dir>ouMYAPP_DEMO=1). Lire ce que fait un flag avant de l'exécuter. Ne jamais exécuter quoi que ce soit qui scanne, nettoie ou écrit des données utilisateur réelles, et ne jamais lancer une deuxième copie d'une application qui conserve un état en direct. Si un flag pourrait faire l'un ou l'autre, s'arrêter et demander. Sinon, sur un Mac, amener l'application au premier plan dans l'état à montrer et exécuterswift <skill-folder>/scripts/capture-window.swift "MonApp" capture.png(la plus grande fenêtre à l'écran de l'application, sans ombre, pixels Retina ; elle ignore un panneau d'encoche ou de barre de menu, qui se trouve sur une couche de fenêtre supérieure, et le signale). iOS :xcrun simctl status_bar booted override --time 9:41 --batteryState charged --batteryLevel 100, puisxcrun simctl io booted screenshot capture.png, puisxcrun simctl status_bar booted clear.Règles pour chaque capture :
- Interface réelle, ciblée. La fenêtre active : feux de circulation colorés, barre latérale allumée. Une fenêtre grise et atténuée est un échec.
- Stabilisée. Pas de compteur en cours, pas de spinner, rien à moitié dessiné.
- Données de démonstration neutres. Pas de noms personnels, de vrais fichiers, de noms de projets ou de comptes, pas de noms de produits d'autres sociétés (sauf si le site de l'application nomme cette intégration). Utiliser le mode démo, jamais une capture de la vraie chose.
- Mode clair si l'application en a un. Les captures sombres sont pour les applications uniquement sombres.
- Pixels 2x. Une carte montre une capture à au plus 1,15x ses propres pixels (le rendu échoue au-dessus), donc une fenêtre a besoin d'environ 1400 px de large pour un aperçu de lien et 2000 px pour une diapositive de galerie.
- Contenu réel. Pas de puits vides, pas de lorem, pas de texte tronqué dans la partie dont le titre parle.
- Qui se lit en petit. L'aperçu de lien montre la capture à environ 600 px de large. Choisir la capture dont le point principal est visible à cette taille (un grand chiffre, une liste claire), pas un panneau de paramètres dense. Rogner à la partie qui compte.
- Une capture
ImageRendererSwiftUI (un îlot d'application d'encoche) vient avec des placeholders jaunes opaques dans ses coins : définir"clean": true. Pour un îlot flottant sur la carte, ajouter"square": true, qui carre les coins jusqu'aux bords du corps. Rogner toute rangée d'encoche vide aveccrop.
Terminé lorsque chaque capture passe la liste. Lire la taille de chaque fichier (
sips -g pixelWidth -g pixelHeight) et la regarder. -
Écrire les mots.
- Titre du lien : le slogan de l'application ou le titre de la page, dans les mots du site : 9 mots ou moins, casse de phrase, pas de point final, pas de tiret, pas de
!. C'est le seul grand texte sur la carte, donc plus c'est court, plus c'est grand. - Pages : si le dépôt a un site avec plusieurs pages, exécuter
node <skill-folder>/scripts/pages.mjs <dossier-site>. Il imprime le<title>et le<h1>de chaque page. Choisir les pages qui valent un aperçu propre (les guides, la page de tarification, les plus grandes fonctionnalités) ; sauter les pages qui nomment le produit d'une autre société. Prendre le<h1>ou le plus court des deux, supprimer le suffixe du nom du site et les balises de style "(2026)", garder à 9 mots. Ne jamais paraphraser. - Diapositives : si
launch-assets/store-screenshots/shots.jsonexiste,"ph": { "fromShots": "../store-screenshots/shots.json" }réutilise ses titres, sous-titres, captures et recadrages (6 premières captures,"limit"change cela). Sinon, écrire 4 à 6 diapositives : la diapositive 1 dit ce qu'est l'application, chaque suivante a un avantage et a du sens seule. Titre 6 mots ou moins, un sous-titre optionnel d'une phrase courte. - Titre de la bannière X : le slogan. 6 mots ou moins.
- Texte alternatif : une phrase qui dit ce que l'image montre. Par défaut
<app>: <titre>. <sous-titre>; écrirealtsur le lien lorsque la capture ajoute quelque chose qui vaut la peine d'être dit.
La copie utilise les propres mots du site. Chaque ligne est tirée du site ou du README et raccourcie ; chaque nombre, nom et affirmation est sur le site. Vérifier chaque ligne avec
rgsur la copie du site avant de la conserver. - Titre du lien : le slogan de l'application ou le titre de la page, dans les mots du site : 9 mots ou moins, casse de phrase, pas de point final, pas de tiret, pas de
-
Écrire
launch-assets/og/og.json.{ "brand": "../brand.json", "out": ".", "wallpaper": "auto", "link": { "title": "Un nettoyeur Mac pour développeurs", "capture": "../captures/apercu.png", "alt": "Shedi, un nettoyeur Mac pour développeurs : 43,84 Go trouvés, triés en "à nettoyer sans risque" et "à vérifier d'abord"" }, "pages": [ { "id": "xcode-deriveddata", "title": "Effacer DerivedData de Xcode", "capture": "../captures/xcode.png" } ], "ph": { "fromShots": "../store-screenshots/shots.json" }, "x": { "title": "Un nettoyeur Mac pour développeurs", "capture": "../captures/apercu.png" } }Laisser de côté
pages,phouxpour sauter ce type. Les chemins sont relatifs àog.json. Une page hérite de tout delink(capture, recadrage, disposition) et écrase ce qu'elle nomme. Options surlink, une page, une diapositive oux:capture(oucaptures, jusqu'à 3, empilées),crop({ x, y, w, h }, 0 à 1 de la capture après suppression des marges transparentes ;cropspour plusieurs captures),clean,square,radius,width(largeur de capture en part de la carte),shadow: false,minCoverage.layout: les cartes lien sontside(titre à gauche, fenêtre s'élevant du bas à droite) oubelow(titre centré, large capture en dessous). Par défaut, choisitbelowpour une capture plus large que 2:1,sidesinon. Les diapositives sontfit(toute la capture, rien coupé),bleed(coupé par le bord inférieur, pour une fenêtre) oupair(2 ou 3 captures empilées). Une diapositive sanslayoutet une capture de fenêtre simple (sansclean) estbleed; tout le reste estfit.minCoverage: le seuil minimal pour la couverture UI (lien 0.3, diapositive 0.4, en-tête 0.12). Une capture qui couvre 80% de la largeur de la carte passe sans cela (un îlot ou une barre fine ne peut pas devenir plus haut). Ne pas abaisser le seuil pour cacher une petite capture : l'afficher plus grande, la rogner ou en choisir une autre.- Sur une diapositive dans
fromShots, ajouter"slides": [{ "id": "<id capture>", ... }]pour écraser les options d'une diapositive.
Arrière-plan, une fois pour toutes les images :
"wallpaper": "auto"choisit l'image fournie dont la teinte est la plus proche de la couleur d'accentuation de la marque (bleu et sarcelle, vert, chaud, rose) et imprime le choix et la raison. Informer l'utilisateur du choix et de la raison, et qu'il peut le changer ("wallpaper": "neige", ou un chemin vers sa propre image lumineuse et calme, d'au moins 2400 px de large). Une accentuation grise, ou à plus de 50 degrés de chaque image, obtient le champ de la marque à la place (le fond de la marque lavé avec un peu de son accentuation). Laisser la clé de côté pour le champ. Ce skill fournit cinq images. -
Rendu.
node <skill-folder>/scripts/render.mjs launch-assets/og/og.jsonUne ligne de sortie par PNG :
okouFAIL, taille, poids du fichier, la police qui a réellement dessiné le titre, le contraste des mots par rapport aux pixels réellement derrière eux, la taille et la hauteur de capitale du titre, la couverture UI et à quel point la capture et le papier peint ont été agrandis.--only link|pages|ph|xrend un seul type (tout le reste échoue). Il écrit aussimeta.html.Les gardes échouent : une taille qui n'est pas exacte, un canal alpha, un fichier de plus de 5 Mo, un contraste de texte inférieur à 4.5:1 (il n'y a pas de voile ; choisir un papier peint plus pâle ou une encre plus foncée), un titre dont la hauteur de capitale est inférieure au minimum (lien 40 px, diapositive 38 px, en-tête 36 px, pour qu'il reste lisible dans un aperçu de 600 px de large) ou qui nécessite plus de lignes que possible, une copie trop longue ou avec tiret (tiret, " - " ou "--") ou
!, une capture agrandie de plus de 1,15x ou un papier peint de plus de 1,2x, une couverture UI inférieure au seuil sauf si la capture couvre 80% de la largeur de la carte (mesurée sur les pixels de contenu de la capture, pas sur sa boîte, donc les zones noires ou blanches vides ne comptent pas), tout ce qui est en dehors de la zone de sécurité X ou à l'intérieur de la zone d'avatar, et un fallback de police : la première famille nommée defonts.familydoit être la police qui a dessiné le titre ("Inter, sans-serif"sans fichier dessinerait SF Pro : FAIL). Une pile qui commence par-apple-systemousystem-uisignifie la police système et échoue uniquement sur un fallback comme Helvetica ou Arial. Corriger chaqueFAILdansog.jsonet rendre à nouveau. -
Contrôle qualité. Requis, et effectué sur les fichiers, pas sur la configuration.
- Taille et alpha :
sips -g pixelWidth -g pixelHeight -g hasAlpha <chaque fichier>. Tailles exactes depuis sizes.md,hasAlpha: no. - Regarder : ouvrir chaque PNG avec l'outil de lecture en taille réelle. Puis
node <skill-folder>/scripts/preview.mjs launch-assets/oget ouvrir_preview-600.pnget_preview-300.png(chaque image à 600 et 300 px de large, comme un fil la montre), puis supprimer les deux fichiers. Pour chaque image, vérifier :- Le titre est lisible à 300 px et rien n'est coupé ou seul sur une deuxième ligne.
- La police dans la ligne de sortie est celle que vous avez demandée.
- La capture est nette, montre le point du titre, n'a pas de texte tronqué et pas de données personnelles.
- Noms : pas de nom ou logo de concurrent ou d'autre société sauf si le site nomme cette intégration ; pas de noms personnels.
- Mots : chaque ligne est le propre libellé du site, raccourci ; chaque nombre est sur le site.
- Bannière X : le coin inférieur gauche (x inférieur à 420, y supérieur à 300) est dégagé pour la photo de profil ; le contenu se situe dans la bande du milieu, loin du haut et du bas de 70 px. Vérifier par rapport à sizes.md et, si possible, sur le vrai profil.
- Ensemble : les diapositives se lisent comme une famille ; il n'y en a pas deux qui font le même point.
- Corriger et rendre à nouveau, puis regarder ce fichier à nouveau.
- Seulement ensuite rapporter : la liste des fichiers, la sortie
sips, et tout ce que vous n'avez pas pu vérifier. Dire à l'utilisateur de copier les PNG sur le site, de collermeta.htmldans<head>, et de rafraîchir l'aperçu mis en cache dans le débogueur de chaque plateforme.
- Taille et alpha :
Règles de look
- Clair d'abord. Un papier peint lumineux ou le champ de la marque, encre foncée dessus. Pas de fond sombre avec néon.
- Pas de lueur, pas de halo. La profondeur est un bord de 1 px et des ombres noires neutres à faible opacité.
- Un travail par image. Un titre, une capture (ou une paire), au plus un sous-titre.
- Grande typographie. Le titre est ce qui survit à une vignette. Une copie courte est ce qui lui permet d'être grand.
- Captures réelles uniquement. L'interface n'est jamais dessinée, redessinée ou générée.