GitHub
Muestra lanzamientos y Gists de GitHub en un sitio de Webflow, despliega aplicaciones desde un repositorio con Webflow Cloud y sincroniza los lanzamientos con el CMS.
Webflow Cloud despliega una aplicación full-stack desde un repositorio y rama de GitHub vinculados, y la vuelve a desplegar con cada push a esa rama. La aplicación se monta en una ruta de tu sitio de Webflow existente, como /app, para que el código publicado conviva con tus páginas de marketing.
Los Gists y distintivos de GitHub se insertan en cualquier página de Webflow mediante un elemento de código incrustado (Code Embed). El servidor MCP de Webflow permite que agentes como Claude Code gestionen elementos del CMS, de modo que los datos de los lanzamientos de GitHub puedan alimentar un registro de cambios en tu sitio de marketing.
Los pasos de configuración que siguen cubren las inserciones y distintivos, los despliegues de Webflow Cloud, Zapier y las API de Webflow y GitHub.
Cómo integrar GitHub con Webflow
¿Qué es GitHub? GitHub es una plataforma para alojar repositorios Git, con pull requests, issues, flujos de trabajo de Actions y Gists integrados. Su servidor MCP oficial también permite que los agentes de IA lean repositorios y lanzamientos.
GitHub y Webflow se conectan de cuatro maneras:
- Incrustaciones y distintivos: Los Gists y las insignias de Shields.io se lucen en tu página, y un script se encarga de renderizar el README sin tocar código del servidor.
- Webflow Cloud: Tu repositorio de GitHub se despliega como app full-stack, y cada push a la rama vinculada activa un despliegue nuevecito.
- Zapier: Cada nueva versión en GitHub crea un elemento en el CMS de Webflow, ¡y sin escribir una sola línea de código!
- API y Actions: Un flujo de GitHub Actions o un pequeño servidor llama a la Data API de Webflow para añadir elementos al CMS o publicar el sitio.
Las inserciones solo muestran datos. Zapier y las API los escriben en el CMS, y Webflow Cloud ejecuta el código que reside en el repositorio.
Muestra contenido de GitHub con elementos incrustados e insignias
Las incrustaciones se libran del código de servidor. Los Gists y el script del README usan el elemento Code Embed, que requiere un plan de Workspace o de Sitio con código personalizado. Las insignias usan este mismo elemento con una simple etiqueta de imagen.
Insertar un Gist para un ejemplo de código
Un Gist genera una etiqueta de script que muestra un bloque de código con resaltado de sintaxis dondequiera que corra JavaScript. La documentación sobre Gists de GitHub te muestra dónde copiar la URL para incrustarlo.
Inserta un Gist en cuatro pasos:
- Crea el Gist y haz clic en el icono del portapapeles junto a su URL de inserción para copiar la etiqueta script.
- En Webflow, abre el panel Añadir y arrastra un elemento de Incrustar código a la página.
- Pega la etiqueta script en el editor de código incrustado, luego guarda y cierra.
- Publica el sitio para ver el Gist renderizado.
Para mostrar un archivo específico de un Gist con varios archivos, añade el nombre del archivo a la URL de inserción:
<script src="https://gist.github.com/USERNAME/GIST_ID.js?file=example.js"></script>
En una página de colección del CMS, un código incrustado puede incluir un campo del CMS, de modo que un campo de texto plano que contenga cada ruta de Gist (NOMBRE_USUARIO/ID_GIST) cambie la inserción según el elemento.
Añadir distintivos de repositorio
Shields.io genera insignias SVG al vuelo con datos de GitHub: estrellas, forks, licencias y hasta el último commit.
Para obtener una insignia de estrella interactiva, pega este código en un elemento Code Embed:
<a href="https://github.com/USERNAME/REPO">
<img src="https://img.shields.io/github/stars/USERNAME/REPO" alt="GitHub stars">
</a>
Cambia stars por forks, license o last-commit para mostrar una métrica diferente del mismo repositorio.
Renderizar un archivo README con JavaScript
La API de contenidos de repositorios de GitHub te devuelve el README ya maquetado en HTML y, además, acepta peticiones desde otros orígenes.
Un pequeño script en un elemento Code Embed puede obtenerla y mostrarla:
<div id="readme"></div>
<script>
fetch('https://api.github.com/repos/OWNER/REPO/readme', {
headers: { Accept: 'application/vnd.github.html+json' }
})
.then((response) => response.text())
.then((html) => {
document.getElementById('readme').innerHTML = html;
});
</script>
Las solicitudes sin autenticar tienen un tope de 60 por hora por cada dirección IP, tal como detallan los límites de frecuencia de la API REST. Si tu página recibe mucho tráfico, mejor obtén el README desde un servidor.
Despliega aplicaciones full-stack con Webflow Cloud
Webflow Cloud despliega una aplicación desde un repositorio de GitHub y la aloja junto a tu sitio de Webflow. Su asistente de despliegue conecta GitHub, instala la aplicación de GitHub de Webflow Cloud, clona una plantilla inicial y ejecuta el primer despliegue.
Una aplicación puede montarse en una ruta como /app en un sitio existente, permitiendo que un sitio de marketing añada una página interactiva sin necesidad de un segundo dominio.
Conectar un repositorio y una rama
Lanza tu primera app con el asistente de despliegue siguiendo estos sencillos pasos:
- Desde el panel de control de Webflow, abre el Espacio de trabajo y haz clic en Crear aplicación.
- Inicia sesión en GitHub, autoriza a Webflow Cloud e instala su aplicación de GitHub en la cuenta u organización que será propietaria del repositorio.
- Clona una plantilla de inicio de Astro o Next.js, o elige una plantilla oficial para otro framework.
- Ponle nombre a la aplicación, elige un Espacio de trabajo y selecciona Nuevo dominio o Sitio existente con una ruta de montaje.
- Haz clic en Desplegar. Los siguientes envíos (pushes) a la rama desplegada iniciarán nuevos despliegues automáticamente.
Webflow Cloud se lleva de maravilla con Next.js, Astro, Vite y apps estáticas, y por ahora GitHub es el único gestor de Git admitido. Webflow tiene plantillas oficiales de inicio para cada framework en la organización Webflow-Examples.
Asignar ramas a entornos
Cada entorno sigue la pista a una rama, así que producción y staging pueden ir por caminos separados. Cada push pone en marcha un despliegue, y la documentación sobre entornos te cuenta cómo las rutas de montaje dirigen el tráfico.
Los entornos se actualizan sin interrupciones y, si un despliegue falla, la última versión operativa sigue al pie del cañón. ¿Toca volver atrás? Revierte la rama a un commit anterior y haz push. Consulta Deployments para ver los registros de compilación.
Las implementaciones en la nube de Webflow y la publicación del sitio son pasos independientes, así que activa cada uno por separado.
Conecta con Zapier
Zapier une los eventos de GitHub con las colecciones del CMS de Webflow por arte de magia y sin código. Sus activadores de GitHub incluyen New Release y New Pull Request, y entre sus acciones para Webflow están Create Item y Create Live Item.
Crea un Zap que convierta cada lanzamiento en un elemento del CMS:
- Crea un Zap con GitHub como aplicación de activación y elige Nuevo lanzamiento.
- Conecta tu cuenta de GitHub y elige el repositorio.
- Añade Webflow como aplicación de acción y elige Crear elemento en vivo para publicar inmediatamente, o Crear elemento para dejar la entrada en borrador.
- Asigna el nombre del lanzamiento, la etiqueta, el cuerpo y la URL a los campos de la colección.
- Prueba el Zap y luego actívalo.
El proceso inverso también funciona: el activador de Nueva respuesta de formulario de Webflow puede alimentar la acción Crear incidencia de GitHub, de modo que un informe de error desde un formulario del sitio llegue a un repositorio. En el plan gratuito, Zapier comprueba si hay datos nuevos en GitHub cada 15 minutos.
Desarrolla con las API de Webflow y GitHub
Si buscas el control total, recurre a la Data API de Webflow desde un flujo de GitHub Actions o tu propio servidor. La API REST de GitHub te sirve repositorios, lanzamientos y listas de colaboradores, mientras que sus webhooks te avisan al instante cada vez que algo cambia.
Mantén los tokens fuera del código de la página. Un token de Webflow con acceso de escritura colocado en un código incrustado es visible para todos los visitantes, así que guárdalo como un secreto del repositorio o en un servidor.
Sincronizar lanzamientos con un registro de cambios del CMS
Un flujo que se active al publicar una versión puede enviar ese lanzamiento directo a una colección del CMS, sin servidores que mantener. GitHub detalla el activador de lanzamientos en su referencia de eventos de flujo de trabajo.
Crea una colección con campos para la versión, las notas de la versión, el enlace y la fecha.
Añade un token de sitio de Webflow con acceso de escritura a CMS y el ID de la colección como secretos del repositorio, luego añade este flujo de trabajo:
name: Sync release to Webflow CMS
on:
release:
types: [published]
jobs:
sync:
if: ${{ !github.event.release.prerelease }}
runs-on: ubuntu-latest
steps:
- name: Create a live CMS item
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
WEBFLOW_TOKEN: ${{ secrets.WEBFLOW_TOKEN }}
COLLECTION_ID: ${{ secrets.WEBFLOW_COLLECTION_ID }}
TAG: ${{ github.event.release.tag_name }}
NOTES: ${{ github.event.release.body }}
URL: ${{ github.event.release.html_url }}
DATE: ${{ github.event.release.published_at }}
run: |
HTML=$(jq -n --arg t "$NOTES" '{text: $t}' | curl -sS -X POST https://api.github.com/markdown -H "Authorization: Bearer $GH_TOKEN" -H "Accept: application/vnd.github+json" --data @-)
jq -n --arg tag "$TAG" --arg html "$HTML" --arg url "$URL" --arg date "$DATE" '{fieldData: {name: $tag, slug: ($tag | ascii_downcase | gsub("[^a-z0-9]+"; "-")), "release-notes": $html, "github-url": $url, "published-date": $date}}' > body.json
curl -sS -f -X POST "https://api.webflow.com/v2/collections/$COLLECTION_ID/items/live" -H "Authorization: Bearer $WEBFLOW_TOKEN" -H "Content-Type: application/json" --data @body.json
El flujo envía los datos al endpoint de elementos en vivo, publicándolos nada más crearse. Pasa las notas de Markdown a HTML mediante el endpoint de Markdown de GitHub, ideal para el campo Rich Text. Solo ajusta los slugs de los campos para que encajen con tu colección.
Sincronizar datos del repositorio con elementos del CMS
Un portafolio o una página de código abierto pueden listar proyectos de GitHub. GET /repos/{owner}/{repo} devuelve el nombre, la descripción, la URL, el número de estrellas, el número de bifurcaciones, el lenguaje y los temas de cada repositorio.
Asocia esos campos a una colección y crea los elementos con el endpoint Create Items. Los elementos preparados necesitan pasar por el endpoint de publicación para dejarse ver en el sitio web. Puedes programar un flujo para que repita la sincronización periódicamente.
Guarda el nombre de cada repositorio junto a su ID de elemento del CMS para que las ejecuciones repetidas actualicen los elementos existentes en lugar de crear duplicados.
Lo que puedes crear con la integración de GitHub y Webflow
Estas compilaciones muestran la actividad de GitHub en un sitio de marketing o ejecutan código desde un repositorio detrás de él:
- Registro de cambios automático: Cada lanzamiento publicado se convierte en un elemento del CMS de Webflow con su versión y notas, y una Collection List se encarga de mostrar las novedades más recientes en primer lugar.
- Página para proyectos de código abierto: Las insignias de Shields.io presumen de estrellas y licencia, mientras una sincronización programada llena la cuadrícula de colaboradores directamente desde la API de GitHub.
- Portafolio para desarrolladores: cada tarjeta de proyecto extrae su descripción y contador de estrellas de GitHub, actualizados al milímetro mediante un flujo programado.
- Notas de versiones en piloto automático: un agente conectado a los servidores MCP de GitHub y Webflow lee los nuevos lanzamientos y crea o pone al día los elementos correspondientes del CMS.
- Tu app bajo el dominio de marketing: una aplicación de Webflow Cloud desplegada desde un repositorio de GitHub que se ejecuta en su propia ruta dentro del mismo sitio web.
El servidor MCP de Webflow conecta clientes de IA como Claude Code y Claude Desktop con el CMS de tu sitio. También puede gestionar apps de Webflow Cloud creadas desde un repositorio de GitHub, incluidos sus entornos y despliegues.
El servidor MCP oficial de GitHub puede listar las versiones de un repositorio. Un agente con ambos servidores puede convertir cada nueva versión en una entrada de registro de cambios, dentro de los permisos de Webflow de la persona que lo autorizó.
Empieza echando un vistazo a la documentación del MCP de Webflow y al servidor MCP de GitHub. Para las llamadas de escritura en el CMS, consulta la guía de la API del CMS de Webflow; y si quieres buscar en un historial de cambios gigante, prueba la guía de búsqueda por facetas.
Preguntas frecuentes
No directamente. GitHub no cuenta con una app en el Marketplace de Webflow. Puedes conectar ambos mundos mediante incrustaciones de Gist y medallas, Webflow Cloud, Zapier o aprovechando las API de Webflow y GitHub.
Sí. Webflow Cloud despliega una aplicación desde un repositorio de GitHub, y cada envío (push) a una rama vinculada inicia un nuevo despliegue. Webflow Cloud es compatible con Next.js, Astro, Vite y aplicaciones estáticas, y GitHub es actualmente el único host de Git admitido.
Para publicar un sitio web de Webflow normal, un flujo de trabajo de GitHub Actions puede llamar al punto de conexión de publicación de sitio. La solicitud necesita un ID de sitio y un token con el ámbito
sites:write, además decustomDomainsopublishToWebflowSubdomainen el cuerpo. Ese punto de conexión permite una cola de publicación exitosa por minuto.En parte sí. Las apps de Webflow Cloud viven en un repositorio de GitHub, por lo que su código sigue el flujo habitual de Git con ramas y commits. La parte visual se versiona dentro de Webflow, que genera copias de seguridad del sitio sobre la marcha y permite a los administradores restaurar versiones anteriores en cualquier momento.
Los scripts que crees y alojes por tu cuenta pueden cargarse mediante el código del head y del body, dejando su código fuente a buen recaudo en un repositorio.
Añade un elemento de incrustación de código (Code Embed), pega la etiqueta de script de la URL de incrustación del Gist y publica. La etiqueta sigue este patrón:
<script src="https://gist.github.com/USERNAME/GIST_ID.js"></script>. Añade?file=FILENAMEpara mostrar un archivo de un Gist con varios archivos.En una página de colección del CMS, la incrustación de código puede incluir un campo del CMS, de modo que un campo de texto sin formato pueda contener la ruta del Gist de cada elemento.
¡Claro que sí! Zapier se encarga de unirlos. Sus activadores de GitHub incluyen New Release y New Pull Request, mientras que sus acciones en Webflow permiten usar Create Item y Create Live Item. En su plan gratuito, Zapier se pasa por GitHub cada 15 minutos para ver si hay novedades.
En la otra dirección, el activador de nueva presentación de formulario de Webflow puede alimentar la acción de crear incidencia de GitHub.
Descripción
Inserta Gists y distintivos, despliega aplicaciones desde un repositorio de GitHub con Webflow Cloud y sincroniza los lanzamientos con el CMS de Webflow mediante GitHub Actions, Zapier o un agente.
Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.

Typed.js
Conecta Typed.js, una biblioteca de animación de escritura en JavaScript, con Webflow para añadir titulares animados que rotan mediante elementos de inserción de código y cadenas gestionadas por el CMS.

Typed.js
Añade Typed.js a Webflow con código personalizado para escribir y repetir el texto de un titular principal, o utiliza palabras rotativas desde campos del CMS.
Sweet Text de Finsweet
Scrollbar Styler de Finsweet
Dale estilo a las barras de desplazamiento de Webflow visualmente con el generador de CSS gratuito de Finsweet, pega el código en tu sitio y añade las propiedades estándar para una compatibilidad total con navegadores.

React
POWR
Añade formularios, ventanas emergentes, temporizadores de cuenta atrás y chat en vivo de POWR a un sitio de Webflow mediante un elemento Code Embed o código en el pie de página, y envía las respuestas de los formularios al CMS a través de Zapier.
One2 Menu
Pega un fragmento de One2 Menu en Webflow y el menú de tu restaurante se mantendrá actualizado desde el panel de control de One2.
MathJax
Conecta MathJax, un motor de visualización matemática de código abierto, con Webflow para renderizar ecuaciones LaTeX como fórmulas tipográficas con accesibilidad integrada, compatibilidad con lectores de pantalla y consistencia entre navegadores.

Listen Notes
Conecta Listen Notes, un motor de búsqueda y API de podcasts, con Webflow para insertar reproductores de episodios, añadir búsquedas de podcasts y completar colecciones del CMS con metadatos de más de 3,7 millones de podcasts.


