Tarjetas de compartir, favicon e iconos de app
Una app desplegada (https://{nombre}.grok.me) se despliega con una tarjeta de 1200×630; cada app (incluyendo la vista previa) muestra un favicon en la pestaña. Las etiquetas <meta> de la tarjeta de compartir no se escriben en __root.tsx — el inyector (scripts/grok-pwa-shared.mjs) sobrescribe og:* y twitter:card en cada respuesta HTML. Los datos de identidad son lo único que alguien escribe, y el pase escribe todo eso — al despachar, no siembras nada de eso:
src/lib/og/site.json— no está pre-sembrado, se crea solo si es necesario:{ "title", "type"?: "x:game", "card"?: "custom", "color"?: "RRGGBB" }; el título por defecto es el slug del host.public/og.jpg— tarjeta personalizada de 1200×630 (opcional; si no, se usa el marcador de posición)public/x-banner.jpg— solo para juegos: tarjeta de feed de X en proporción 50:11 (1200×264)public/favicon.svg— enlazado desde elhead()raíz; hasta que el pase lo coloque, la pestaña muestra el icono por defecto del navegador, lo cual no falla nada
Extiende __root.tsx; nunca lo reemplaces por completo (SSR de autenticación, rediseños, extractos de habilidades): eliminar el enlace al favicon envía un icono de pestaña en blanco que ninguna comprobación local detecta.
Decidir: qué tarjeta recibe esta app
Por defecto: una tarjeta personalizada a partir del arte propio de la app — juegos de todo tipo y tecnología de renderizado (Canvas/WebGL y tablero DOM, cartas, palabras, rompecabezas, trivia: una cuadrícula de tres en raya de divs sigue siendo un juego), apps caprichosas, herramientas creativas, páginas de contenido y de marca. En caso de duda, haz la tarjeta personalizada.
Solo las apps de utilidad simple (convertidores, rastreadores CRUD, paneles, notas/admin — apps cuya cara son los datos) mantienen el marcador de posición por defecto de og.grok.me: no hay public/og.jpg. Su URL, el knob "color" y la regla de renombrado: references/placeholder-card.md.
og:type para juegos
Un juego de cualquier tipo lleva "type": "x:game" en src/lib/og/site.json — el pase lo escribe, siendo el dueño de ese archivo. Sin nombre de host, nunca condicionado a una tarjeta personalizada, nunca "corregido" a website, game simple, twitter:card o un x:type inventado: la tubería de X depende de ese valor exacto. Las no-juegos lo omiten. Tu verificación, no tu edición — si falta, o si falta public/x-banner.jpg una vez que existe una tarjeta personalizada, es una ADVERTENCIA DE MARCA.
Pase de assets de marca: siempre un subagente, nunca se espera por él
¿Tienes la herramienta task? Despacha este pase como subagente y nunca generes el arte de la tarjeta tú mismo — hacerlo en línea pone minutos de latencia de generación frente al usuario. Tan pronto como el nombre y la paleta se estabilicen (AGENTS.md § "Trabajo paralelo"), despacha este mensaje textualmente. Está completo — no abras las referencias a continuación para enriquecerlo; el pase las lee por sí mismo:
Eres el pase de assets de marca. Sigue la habilidad
og, que te dice por dónde empezar. App<NOMBRE>,og:type<TIPO>, paleta<PALETA>. Eres el único dueño de los assets de marca enpublic/y desrc/lib/og/site.json.
Sigue construyendo. Mantente secuencial solo si el usuario está dirigiendo el arte o el arte a reutilizar aún no existe.
Nunca esperes por él. No uses wait_tasks, y nunca uses get_task_output en la tarea de marca: leer la salida de una tarea la consume, y una tarea consumida no envía notificación de finalización, por lo que el resultado de la tarjeta — incluyendo un fallo — no llegaría a nadie. Responde tan pronto como la app se renderice; el pase te despierta más tarde, y ese turno es como máximo una oración corta — una que pida una republicación, ya que public/og.jpg se envía en la compilación y una tarjeta que llega después de una publicación nunca llega a la app en vivo por sí sola:
"Se añadió la tarjeta de compartir — publica de nuevo si ya lo hiciste." / "La tarjeta falló; se queda la predeterminada."
Mientras el pase mantenga fresco /workspace/.grok/og-pending, las comprobaciones de marca no dicen nada sobre la tarjeta: en vuelo no es un hallazgo. El marcador se vuelve obsoleto después de 10 minutos, por lo que un pase muy largo deja pasar la advertencia — pero una advertencia de marca mientras se ejecuta nunca es una señal para rehacer su trabajo.
¿No tienes la herramienta task? Entonces tú eres el pase — construye los assets ahora; nadie más lo hará. Quien lo ejecute reclama ese marcador, prepara archivos bajo /workspace/.grok/ — nunca dentro de public/, que vite build copia textualmente en la app desplegada — los entrega con scripts/write-atomic.mjs para que ninguna compilación lea medio JPEG, y se auto-verifica con node scripts/brand-check.mjs --game.
Construir los assets — el pase lee esto, el padre no
¿Despachando? No los abras — el mensaje anterior está completo. Una lectura lleva este procedimiento en tu contexto en cada turno posterior mientras el subagente hace el trabajo de todas formas.
¿Eres el pase? Empieza en references/brand-pass.md, luego lee por cada asset que debes: references/custom-card.md para public/og.jpg, references/x-banner.md para el public/x-banner.jpg solo para juegos, references/favicon-and-icons.md para public/favicon.svg más los iconos rasterizados de PWA — esos solo cuando el usuario pidió instalable/PWA, nunca inventes un manifiesto. Escribe ese SVG a mano, nunca uses imagine_text_to_image: debe mantenerse nítido a 16px. ¿Escribiendo site.json para un juego? references/og-type-contract.md discute las grafías que X rechaza.
Regenera al renombrar o con un cambio material de identidad — APP_NAME, el title de site.json y el título de la tarjeta incrustada se mueven juntos. Sin imagine_text_to_image o la API de Imágenes de xAI, mantén la tarjeta de og.grok.me; nunca envies una URL de og:image rota.
No soportado
No hay ruta /api/og, ni renderizador de imágenes en tiempo de ejecución, ni tarjetas por ruta — la tarjeta es una imagen estática de todo el sitio (public/og.jpg o el servicio de marcador de posición). Si añades robots.txt, nunca uses un Disallow: / general: los rastreadores deben obtener / para leer las etiquetas.