Cartões de compartilhamento, favicon e ícones de aplicativos
Um aplicativo implantado (https://{nome}.grok.me) é exibido com um cartão de 1200×630; todo aplicativo (incluindo pré-visualizações) mostra um favicon na aba. As tags <meta> do cartão de compartilhamento não são escritas em __root.tsx — o injetor (scripts/grok-pwa-shared.mjs) sobrescreve og:* e twitter:card em toda resposta HTML. Os dados de identidade são a única coisa que alguém escreve, e o passe escreve tudo — ao despachar, você não fornece nada disso:
src/lib/og/site.json— não pré-preenchido, criado apenas se necessário:{ "title", "type"?: "x:game", "card"?: "custom", "color"?: "RRGGBB" }; o título padrão é o slug do host.public/og.jpg— cartão customizado 1200×630 (opcional; caso contrário, placeholder)public/x-banner.jpg— apenas para jogos: cartão 50:11 (1200×264) para feed do Xpublic/favicon.svg— vinculado a partir dohead()raiz; até o passe ser executado, a aba mostra o padrão do navegador, o que não falha nada
Estenda __root.tsx; nunca substitua completamente (SSR de autenticação, reformulações, trechos de skills): remover o link do favicon resulta em um ícone de aba em branco que nenhuma verificação local detecta.
Decidir: qual cartão este aplicativo receberá
Padrão: um cartão personalizado a partir da própria arte do aplicativo — jogos de todos os tipos e tecnologias de renderização (Canvas/WebGL e tabuleiro DOM, cartas, palavras, quebra-cabeças, quiz: uma grade de divs de jogo-da-velha ainda é um jogo), aplicativos lúdicos, ferramentas criativas, páginas focadas em conteúdo e marca. Em caso de dúvida, faça o cartão personalizado.
Apenas aplicativos utilitários simples (conversores, rastreadores CRUD, painéis, notas/admin — aplicativos cuja cara são os dados) mantêm o placeholder padrão do og.grok.me: sem public/og.jpg. Sua URL, o controle "color" e a regra de renomeação: references/placeholder-card.md.
og:type para jogos
Um jogo de qualquer tipo carrega "type": "x:game" em src/lib/og/site.json — o passe escreve, sendo dono desse arquivo. Sem nome de host, nunca condicionado a um cartão personalizado, nunca "corrigido" para website, game simples, twitter:card ou um x:type inventado: o pipeline do X depende exatamente desse valor. Não-jogos o omitem. Sua verificação, não sua edição — faltando, ou faltando public/x-banner.jpg uma vez que um cartão personalizado exista, é um AVISO DE MARCA.
Passe de ativos de marca: sempre um subagente, nunca esperado
Tem a ferramenta task? Despache este passe como um subagente e nunca gere arte de cartão você mesmo — colocá-lo inline coloca minutos de latência de geração na frente do usuário. Assim que o nome e a paleta estiverem definidos (AGENTS.md § "Trabalho paralelo"), despache este prompt literalmente. Ele está completo — não abra as referências abaixo para enriquecê-lo; o passe as lê sozinho:
Você é o passe de ativos de marca. Siga o skill
og, que informa por onde começar. Aplicativo<NOME>,og:type<TIPO>, paleta<PALETA>. Você é o único dono dos ativos de marcapublic/e desrc/lib/og/site.json.
Continue construindo. Mantenha-se sequencial apenas se o usuário estiver dirigindo a arte ou a arte a ser reutilizada ainda não existir.
Nunca espere por ele. Sem wait_tasks, e nunca get_task_output na tarefa de marca: ler a saída de uma tarefa a consome, e uma tarefa consumida não envia notificação de conclusão, então o resultado do cartão — incluindo falha — não chegaria a ninguém. Responda assim que o aplicativo renderizar; o passe o acorda mais tarde, e essa vez é no máximo uma frase curta — uma que peça uma republicação, já que public/og.jpg é enviado na build e um cartão que chega após uma publicação nunca alcança o aplicativo ao vivo sozinho: "Cartão de compartilhamento adicionado — publique novamente se já o fez." / "O cartão falhou; o padrão permanece."
Enquanto o passe mantém /workspace/.grok/og-pending atualizado, verificações de marca não dizem nada sobre o cartão: em andamento não é uma constatação. O marcador fica obsoleto após 10 minutos, então um passe muito longo deixa o aviso passar — mas um aviso de marca enquanto ele está em execução nunca é uma dica para refazer seu trabalho.
Sem ferramenta task? Então você é o passe — construa os ativos agora; nada mais fará. Quem o executar reivindica esse marcador, prepara arquivos em /workspace/.grok/ — nunca dentro de public/, que vite build copia literalmente para o aplicativo implantado — entrega com scripts/write-atomic.mjs para que nenhuma build leia meio JPEG, e faz auto-verificação com node scripts/brand-check.mjs --game.
Construir os ativos — o passe os lê, o pai não
Despachando? Não os abra — o prompt acima está completo. Uma leitura carrega este procedimento em seu contexto a cada turno posterior enquanto o subagente faz o trabalho de qualquer forma.
Você é o passe? Comece em references/brand-pass.md, depois leia por ativo que você deve: references/custom-card.md para public/og.jpg, references/x-banner.md para o banner exclusivo de jogos public/x-banner.jpg, references/favicon-and-icons.md para public/favicon.svg mais os ícones raster PWA — estes apenas quando o usuário pedir instalável/PWA, nunca invente um manifesto. Escreva manualmente aquele SVG, nunca imagine_text_to_image: ele deve permanecer nítido a 16px. Escrevendo site.json para um jogo? references/og-type-contract.md argumenta as grafias que o X rejeita.
Regenere ao renomear ou em uma mudança material de identidade — APP_NAME, o title do site.json e o título do cartão embutido mudam juntos. Sem imagine_text_to_image ou a API xAI Images, mantenha o cartão og.grok.me; nunca envie uma URL og:image quebrada.
Não suportado
Nenhuma rota /api/og, nenhum renderizador de imagem em tempo de execução, nenhum cartão por rota — o cartão é uma única imagem estática para todo o site (public/og.jpg ou o serviço de placeholder). Se você adicionar robots.txt, nunca coloque Disallow: / de forma geral: rastreadores devem buscar / para ler as tags.