Prepara el archivo adecuado
Las indicaciones actuales de GitHub admiten archivos PNG, JPG o GIF de menos de 1 MB. Recomiendan al menos 640 × 320 píxeles y 1280 × 640 para una visualización óptima. Empieza con el lienzo más grande de proporción 2:1 y comprueba después la legibilidad a un tamaño mucho menor.
Para un validador de CSV ficticio, un diseño claro podría mostrar el nombre del proyecto, «Comprueba archivos CSV antes de importarlos» y un ejemplo sencillo que relacione una entrada con un error. No comprimas una sesión entera de terminal en una miniatura. Aleja el texto importante de los bordes por si la plataforma donde se comparte recorta la imagen.
Sube la imagen y comprueba el enlace compartido
Abre Settings del repositorio, busca Social preview, elige Edit y sube la imagen. Comparte la URL pública del repositorio en el destino donde la verá tu público. Comprueba allí el resultado; una subida correcta no garantiza que todas las plataformas sustituyan inmediatamente una vista previa almacenada en caché.
- Confirma que la imagen corresponde al repositorio que estás compartiendo.
- Comprueba el formato, las dimensiones en píxeles y el tamaño del archivo antes de subirlo.
- Usa un contraste legible; examina las ilustraciones transparentes sobre fondos claros y oscuros.
- Si la imagen está desactualizada, confirma el ajuste guardado del repositorio e investiga la caché de la plataforma de destino.
Mantén la vista previa coherente con el proyecto
Usa el mismo nombre y propósito del proyecto en la imagen, el README y el anuncio de la versión. Si una captura muestra una función experimental, indícalo o usa un flujo de trabajo estable. No añadas recuentos de Stars, logotipos de clientes ni afirmaciones de rendimiento inventados.
Revisa la imagen cuando cambie el caso de uso principal del proyecto. Una vista previa es un recurso de comunicación, no una garantía independiente de posicionamiento, tasa de clics o Stars de GitHub.
Preguntas frecuentes
¿Es lo mismo que el avatar del propietario del repositorio?
No. El avatar del propietario identifica la cuenta. Una vista previa social personalizada representa un proyecto concreto cuando se comparte su enlace.
¿Puede la vista previa tener un fondo transparente?
GitHub admite transparencia en PNG. Comprueba el contraste sobre distintos fondos; un fondo sólido es una opción práctica cuando no conoces la apariencia del destino.
¿Por qué sigo viendo la vista previa antigua después de subir la imagen?
Primero comprueba que la nueva imagen se haya guardado en el repositorio correcto. Las plataformas pueden almacenar las vistas previas en caché; su actualización es independiente del ajuste del repositorio.