Cartes de partage, favicon et icônes d'application
Une application déployée (https://{nom}.grok.me) se dévoile avec une carte 1200×630 ; chaque application (y compris l'aperçu) affiche un favicon dans l'onglet. Les balises <meta> de la carte de partage ne sont pas écrites dans __root.tsx — l'injecteur (scripts/grok-pwa-shared.mjs) écrase og:* et twitter:card à chaque réponse HTML. Les données d'identité sont la seule chose que quiconque écrit, et le passage écrit tout — en dispatchant, vous n'en initialisez rien :
src/lib/og/site.json— non pré-initialisé, créé seulement si nécessaire :{ "title", "type"?: "x:game", "card"?: "custom", "color"?: "RRGGBB" }; le titre par défaut est le slug de l'hôte.public/og.jpg— carte personnalisée 1200×630 (optionnelle ; sinon placeholder)public/x-banner.jpg— jeux uniquement : 50:11 (1200×264) carte de flux Xpublic/favicon.svg— liée depuis lehead()racine ; tant que le passage n'a pas atterri, l'onglet montre juste le navigateur par défaut, ce qui n'échoue rien
Étendez __root.tsx ; ne le remplacez jamais en bloc (SSR d'auth, redesigns, extraits de compétence) : supprimer le lien favicon envoie une icône d'onglet vierge qu'aucune vérification locale ne détecte.
Décider : quelle carte cette application obtient
Par défaut : une carte personnalisée à partir de l'art de l'application elle-même — jeux de toutes sortes et technologies de rendu (Canvas/WebGL et plateau DOM, cartes, mots, puzzles, quiz : une grille de morpion en divs est toujours un jeu), applications fantaisistes, outils créatifs, pages axées contenu et marque. En cas de doute, créez la carte personnalisée.
Applications utilitaires simples uniquement (convertisseurs, traceurs CRUD, tableaux de bord, notes/admin — applications dont le visage sont les données) conservent le placeholder par défaut de og.grok.me : pas de public/og.jpg. Son URL, le réglage "color" et la règle de renommage : references/placeholder-card.md.
og:type pour les jeux
Un jeu de toute nature porte "type": "x:game" dans src/lib/og/site.json — le passage l'écrit, possédant ce fichier. Pas de nom d'hôte, jamais conditionné à une carte personnalisée, jamais "corrigé" en website, game nu, twitter:card ou un x:type inventé : le pipeline de X se base sur cette valeur exacte. Les non-jeux l'omettent. Votre vérification, pas votre édition — l'omettre, ou omettre public/x-banner.jpg une fois qu'une carte personnalisée existe, est un AVERTISSEMENT DE MARQUE.
Passage des assets de marque : toujours un sous-agent, jamais attendu
Avez-vous l'outil task ? Dispatchez ce passage en tant que sous-agent et ne générez jamais l'art de la carte vous-même — l'inline met des minutes de latence de génération devant l'utilisateur. Dès que le nom et la palette sont fixés (AGENTS.md § "Travail parallèle"), dispatchez cette invite textuellement. Elle est complète — n'ouvrez pas les références ci-dessous pour l'enrichir ; le passage les lit lui-même :
Vous êtes le passage des assets de marque. Suivez la compétence
og, qui vous indique par où commencer. Application<NOM>,og:type<TYPE>, palette<PALETTE>. Vous possédez uniquement les assets de marquepublic/etsrc/lib/og/site.json.
Continuez à construire. Restez séquentiel uniquement si l'utilisateur dirige l'art ou si l'art à réutiliser n'existe pas encore.
Ne l'attendez jamais. Pas de wait_tasks, et ne faites jamais get_task_output sur la tâche de marque : lire la sortie d'une tâche la consomme, et une tâche consommée n'envoie aucune notification de complétion, donc le résultat de la carte — y compris un échec — n'atteindrait personne. Répondez dès que l'application s'affiche ; le passage vous réveille plus tard, et ce tour est au maximum une phrase courte — une qui demande une republication, puisque public/og.jpg est livré dans la construction et qu'une carte qui atterrit après une publication n'atteint jamais l'application en ligne seule :
"Carte de partage ajoutée — republiez si vous l'avez déjà fait." / "La carte a échoué ; la carte par défaut reste en place."
Pendant que le passage maintient /workspace/.grok/og-pending à jour, les vérifications de marque ne disent rien sur la carte : en vol n'est pas un constat. Le marqueur devient obsolète après 10 minutes, donc un passage très long laisse passer l'avertissement — mais un avertissement de marque pendant son exécution n'est jamais un signal pour refaire son travail.
Pas d'outil task ? Alors vous êtes le passage — construisez les assets maintenant ; rien d'autre ne le fera. Celui qui l'exécute réclame ce marqueur, met les fichiers en scène sous /workspace/.grok/ — jamais dans public/, que vite build copie textuellement dans l'application déployée — les remet avec scripts/write-atomic.mjs pour qu'aucune construction ne lise un demi-JPEG, et s'auto-vérifie avec node scripts/brand-check.mjs --game.
Construire les assets — le passage les lit, le parent ne le fait pas
En dispatchant ? Ne les ouvrez pas — l'invite ci-dessus est complète. Une lecture porte cette procédure dans votre contexte pour chaque tour ultérieur pendant que le sous-agent fait le travail de toute façon.
Vous êtes le passage ? Commencez par references/brand-pass.md, puis lisez
par asset que vous devez : references/custom-card.md pour public/og.jpg, references/x-banner.md pour la bannière X réservée aux jeux public/x-banner.jpg, references/favicon-and-icons.md pour public/favicon.svg plus les icônes raster PWA — celles-ci uniquement lorsque l'utilisateur a demandé installable/PWA, n'inventez jamais un manifeste. Rédigez ce SVG à la main, jamais imagine_text_to_image : il doit rester net à 16px. Écrire site.json pour un jeu ? references/og-type-contract.md explique les orthographes que X rejette.
Régénérez lors d'un renommage ou d'un changement d'identité matériel — APP_NAME, le title de site.json et le titre de carte intégré bougent ensemble. Sans imagine_text_to_image ou l'API xAI Images, conservez la carte og.grok.me ; n'envoyez jamais une URL og:image cassée.
Non pris en charge
Pas de route /api/og, pas de rendu d'image runtime, pas de cartes par route — la carte est une image statique à l'échelle du site (public/og.jpg ou le service de placeholder). Si vous ajoutez robots.txt, jamais de Disallow: / général : les robots doivent récupérer / pour lire les balises.