CommunityImagemgithub.com

imagens-compartilhamento-sociais

Cria as imagens de compartilhamento e ícones que um site Next.js App Router precisa — uma imagem Open Graph de 1200×630 gerada com next/og ImageResponse, tags do Twitter/X, favicon, ícones de aplicativo e ícone Apple Touch, além de imagens OG por página para postagens de blog — e as verifica com um script de checagem. Use quando o usuário mencionar imagem OG, pré-visualização social, cartão de compartilhamento, cartão do Twitter, favicon ou ícone de aplicativo, ou quando links para o site não mostram imagem no X, LinkedIn, Slack, Discord ou WhatsApp.

O que é imagens-compartilhamento-sociais?

Esta skill automatiza a criação de todas as imagens de compartilhamento social e ícones para sites Next.js com App Router. Ela gera uma imagem Open Graph de 1200×630 para todo o site usando `ImageResponse` do `next/og`, além de imagens OG por página para posts de blog, documentação e páginas de produto. Também cria favicon, ícone de aplicativo e ícone Apple Touch. A skill inclui verificação com um script Node que checa tags OG, tamanho do arquivo, dimensões e URL absoluta, além de fornecer orientações sobre exportação estática e configuração de `metadataBase`. Suporta Next.js App Router e funciona com configurações de exportação estática, com dicas para evitar problemas de Content-Type em hosts estáticos.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Imagens de compartilhamento social e ícones

Quando alguém colar o link do site no X, LinkedIn, Slack, Discord ou WhatsApp, uma imagem grande com um título legível deve aparecer. Navegadores e celulares devem mostrar um ícone nítido.

1. Inspecionar

  • Pasta App (src/app/ ou app/), favicon.ico existente, icon.*, apple-icon.*, opengraph-image.*, twitter-image.*.
  • metadataBase no layout raiz. Sem ele, as URLs de og:image são relativas e as plataformas sociais as ignoram. Se estiver faltando, adicione-o (veja a skill launch-seo, ou defina metadataBase: new URL("https://seu-dominio.com")).
  • next.config.*: output: "export"?
  • Marca: nome, slogan, cor primária, logotipo (SVG preferido). Reutilize tokens de globals.css.
  • Leia a documentação correspondente à versão:
    • 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. Imagem Open Graph (para todo o site)

Copie assets/opengraph-image.tsx para app/opengraph-image.tsx e edite os valores da marca. Ele exporta alt, size (1200×630) e contentType, e desenha a imagem com ImageResponse de next/og.

Regras de design para imagens de compartilhamento:

  • Título de 3 a 8 palavras, com pelo menos 64 px, alto contraste. Deve ser legível como uma miniatura de 300 px de largura.
  • Mantenha o conteúdo importante dentro da área central de 1000×500; algumas plataformas cortam as bordas.
  • Marca + nome do domínio em um canto para que as pessoas saibam para onde o link vai.
  • Apenas Flexbox: ImageResponse suporta um subconjunto de CSS (display: flex, sem grid). Todo elemento com mais de um filho precisa de display: "flex".
  • Fontes: a fonte padrão funciona imediatamente. Para uma fonte personalizada, carregue um arquivo .ttf/.otf/.woff (não .woff2) com readFile e passe-o na opção fonts, conforme mostrado na documentação.
  • Limite de tamanho: 8 MB para Open Graph, 5 MB para Twitter. Os PNGs gerados geralmente têm menos de 100 KB.

twitter-image é opcional: quando está faltando, o X usa a imagem Open Graph. Certifique-se de que os metadados raiz definam twitter: { card: "summary_large_image" }.

3. Imagens por página (posts de blog, documentação, páginas de produto)

Adicione opengraph-image.tsx dentro do segmento dinâmico, por exemplo app/blog/[slug]/opengraph-image.tsx. Ele recebe params (uma Promise) e pode carregar o título do post; exporte generateStaticParams do arquivo de imagem para que cada imagem seja pré-renderizada. Mantenha o mesmo modelo para que todos os compartilhamentos pareçam de uma única marca.

Isso é mais importante do que parece: quando uma página define seu próprio openGraph em metadata/generateMetadata, ele substitui o objeto openGraph do pai, e a imagem de compartilhamento raiz desaparece dessa página. Um arquivo opengraph-image no nível do segmento (ou um openGraph.images explícito) resolve o problema.

4. Ícones

Arquivo (em app/)TamanhoFinalidade
favicon.ico32×32 (vários tamanhos ok)Aba do navegador, obrigatório na raiz do app
icon.png ou icon.svg512×512 PNG ou SVGNavegadores modernos, Android
apple-icon.png180×180Tela inicial do iOS

Você também pode gerar icon.tsx / apple-icon.tsx com ImageResponse — veja assets/icon.tsx. Substitua o favicon.ico padrão do create-next-app antes do lançamento; se nenhuma ferramenta .ico estiver disponível, um icon.png de 32×32 mais a remoção do antigo favicon.ico é aceitável.

5. Nota sobre exportação estática

Com output: "export" (testado no Next.js 16.4):

  • cacheComponents deve estar desligado para uma exportação estática, e cada arquivo de imagem gerado (opengraph-image.tsx, icon.tsx, apple-icon.tsx) precisa de export const dynamic = "force-static";, caso contrário a build falha. Segmentos dinâmicos também precisam de generateStaticParams.
  • As imagens geradas são exportadas sem extensão de arquivo (out/opengraph-image), então hosts estáticos as servem sem cabeçalho Content-Type (verificado no Cloudflare Pages). Alguns crawlers rejeitam isso. A melhor correção para a imagem de todo o site: abra /opengraph-image no site em execução, salve-o e commite-o como app/opengraph-image.png (depois exclua o .tsx); ele exporta como opengraph-image.png com o tipo correto. O mesmo para ícones (app/icon.png, app/apple-icon.png). Para imagens por post, defina Content-Type: image/png para esses caminhos no arquivo de cabeçalhos do host (public/_headers no Cloudflare Pages/Netlify).

6. Verificar

  1. npm run build deve passar. A saída da build lista as rotas opengraph-image.

  2. Inicie o site (npm run start, ou sirva a pasta out/) e execute o verificador (Node 18+, sem dependências). <skill-dir> é a pasta que contém este SKILL.md:

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

    Ele lê as tags og:* e twitter:* da página, baixa a imagem e verifica URL absoluta, status HTTP, tamanho do arquivo, dimensões (1200×630), og:image:alt e twitter:card. URLs de localhost nas tags são relatadas, pois significam que metadataBase está faltando ou errado para produção.

  3. Abra a URL da imagem no navegador e olhe para ela. Verifique se o texto é legível quando a janela do navegador está estreita.

  4. Após o deploy, diga ao usuário para testar com as próprias ferramentas das plataformas (LinkedIn Post Inspector, o Facebook Sharing Debugger). Elas também atualizam as pré-visualizações em cache.

Relatório

Liste os arquivos de imagem e ícone criados, a saída do verificador e um lembrete de que as plataformas armazenam pré-visualizações em cache: após alterar a imagem, faça uma nova raspagem com as ferramentas acima.

Habilidades Relacionadas