Imágenes sociales e iconos para compartir
Cuando alguien pega el enlace del sitio en X, LinkedIn, Slack, Discord o WhatsApp, debe aparecer una imagen grande con un titular legible. Los navegadores y teléfonos deben mostrar un icono nítido.
1. Inspeccionar
- Carpeta App (
src/app/oapp/), archivos existentesfavicon.ico,icon.*,apple-icon.*,opengraph-image.*,twitter-image.*. metadataBaseen el layout raíz. Sin él, las URLsog:imageson relativas y las plataformas sociales las ignoran. Si falta, agrégalo (consulta el skilllaunch-seo, o establecemetadataBase: new URL("https://your-domain.com")).next.config.*: ¿output: "export"?- Marca: nombre, eslogan, color primario, logotipo (SVG preferido). Reutiliza tokens de
globals.css. - Lee la documentación de la versión correspondiente:
node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.mdnode_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.mdnode_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md
2. Imagen Open Graph (para todo el sitio)
Copia assets/opengraph-image.tsx a app/opengraph-image.tsx y edita los valores de la marca. Exporta alt, size (1200×630) y contentType, y dibuja la imagen con ImageResponse de next/og.
Reglas de diseño para las imágenes para compartir:
- Titular de 3 a 8 palabras, al menos 64 px, con alto contraste. Debe ser legible como una miniatura de 300 px de ancho.
- Mantén el contenido importante dentro del área central de 1000×500 píxeles; algunas plataformas recortan los bordes.
- Marca + nombre de dominio en una esquina para que la gente sepa a dónde va el enlace.
- Solo Flexbox:
ImageResponsesoporta un subconjunto de CSS (display: flex, sin grid). Cada elemento con más de un hijo necesitadisplay: "flex". - Fuentes: la fuente predeterminada funciona directamente. Para una fuente personalizada, carga un archivo
.ttf/.otf/.woff(no.woff2) conreadFiley pásalo en la opciónfonts, como se muestra en la documentación. - Límite de tamaño: 8 MB para Open Graph, 5 MB para Twitter. Los PNG generados suelen tener menos de 100 KB.
twitter-image es opcional: cuando falta, X usa la imagen Open Graph. Asegúrate de que los metadatos raíz establezcan twitter: { card: "summary_large_image" }.
3. Imágenes por página (publicaciones de blog, documentación, páginas de producto)
Añade opengraph-image.tsx dentro del segmento dinámico, por ejemplo app/blog/[slug]/opengraph-image.tsx. Recibe params (una Promesa) y puede cargar el título del post; exporta generateStaticParams desde el archivo de imagen para que cada imagen se renderice previamente. Mantén la misma plantilla para que todas las imágenes compartidas parezcan de una sola marca.
Esto importa más de lo que parece: cuando una página establece su propio openGraph en metadata/generateMetadata, reemplaza el objeto openGraph del padre y la imagen de portada raíz desaparece de esa página. Un archivo opengraph-image a nivel de segmento (o openGraph.images explícito) lo soluciona.
4. Iconos
Archivo (en app/) | Tamaño | Propósito |
|---|---|---|
favicon.ico | 32×32 (multitamaño ok) | Pestaña del navegador, requerido en la raíz de la app |
icon.png o icon.svg | 512×512 PNG o SVG | Navegadores modernos, Android |
apple-icon.png | 180×180 | Pantalla de inicio de iOS |
También puedes generar icon.tsx / apple-icon.tsx con ImageResponse — consulta assets/icon.tsx. Reemplaza el favicon.ico predeterminado de create-next-app antes del lanzamiento; si no hay una herramienta para .ico, un icon.png de 32×32 más la eliminación del antiguo favicon.ico es aceptable.
5. Nota sobre exportación estática
Con output: "export" (probado en Next.js 16.4):
cacheComponentsdebe estar desactivado para una exportación estática, y cada archivo de imagen generado (opengraph-image.tsx,icon.tsx,apple-icon.tsx) necesitaexport const dynamic = "force-static";, o la compilación falla. Los segmentos dinámicos también necesitangenerateStaticParams.- Las imágenes generadas se exportan sin extensión de archivo (
out/opengraph-image), por lo que los hosts estáticos las sirven sin cabeceraContent-Type(verificado en Cloudflare Pages). Algunos rastreadores lo rechazan. La mejor solución para la imagen de todo el sitio: abre/opengraph-imageen el sitio en ejecución, guárdalo y confírmalo comoapp/opengraph-image.png(luego elimina el.tsx); se exporta comoopengraph-image.pngcon el tipo correcto. Lo mismo para los iconos (app/icon.png,app/apple-icon.png). Para imágenes por publicación, estableceContent-Type: image/pngpara esas rutas en el archivo de cabeceras del host (public/_headersen Cloudflare Pages/Netlify).
6. Verificar
-
npm run builddebe pasar. La salida de compilación lista las rutasopengraph-image. -
Inicia el sitio (
npm run start, o sirve la carpetaout/) y ejecuta el comprobador (Node 18+, sin dependencias).<skill-dir>es la carpeta que contiene este SKILL.md:node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-postLee las etiquetas
og:*ytwitter:*de la página, descarga la imagen y comprueba URL absoluta, estado HTTP, tamaño de archivo, dimensiones (1200×630),og:image:altytwitter:card. Las URLs con localhost en las etiquetas se reportan, porque significan quemetadataBasefalta o está mal configurado para producción. -
Abre la URL de la imagen en el navegador y mírala. Verifica que el texto sea legible cuando la ventana del navegador es estrecha.
-
Después del despliegue, dile al usuario que pruebe con las herramientas propias de las plataformas (LinkedIn Post Inspector, Facebook Sharing Debugger). Estas también actualizan las vistas previas en caché.
Reporte
Enumera los archivos de imagen e icono creados, la salida del comprobador y un recordatorio de que las plataformas guardan en caché las vistas previas: después de cambiar la imagen, vuelve a rastrear con las herramientas anteriores.