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.

→
↗
►
↓
←
↑
Instalar aplicación
→
↗
►
↓
←
↑
Ver sitio web
→
↗
►
↓
←
↑
Ver lección
→
↗
►
↓
←
↑
Configuración de registros A
→
↗
►
↓
←
↑
Configuración de registros CNAME
GitHub

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:

  1. Crea el Gist y haz clic en el icono del portapapeles junto a su URL de inserción para copiar la etiqueta script.
  2. En Webflow, abre el panel Añadir y arrastra un elemento de Incrustar código a la página.
  3. Pega la etiqueta script en el editor de código incrustado, luego guarda y cierra.
  4. 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:

  1. Desde el panel de control de Webflow, abre el Espacio de trabajo y haz clic en Crear aplicación.
  2. 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.
  3. Clona una plantilla de inicio de Astro o Next.js, o elige una plantilla oficial para otro framework.
  4. Ponle nombre a la aplicación, elige un Espacio de trabajo y selecciona Nuevo dominio o Sitio existente con una ruta de montaje.
  5. 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:

  1. Crea un Zap con GitHub como aplicación de activación y elige Nuevo lanzamiento.
  2. Conecta tu cuenta de GitHub y elige el repositorio.
  3. 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.
  4. Asigna el nombre del lanzamiento, la etiqueta, el cuerpo y la URL a los campos de la colección.
  5. 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 de customDomains o publishToWebflowSubdomain en 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=FILENAME para 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.

GitHub
GitHub
Joined in

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.

→
↗
►
↓
←
↑
Instalar aplicación

Esta página de integración se ofrece únicamente con fines informativos y de conveniencia.


Other Biblioteca de plugins e integraciones integrations

Other Biblioteca de plugins e integraciones integrations

Librería CMS: Slider

Librería CMS: Slider

¡Crea un slider de CMS con un número dinámico de diapositivas usando la librería CMS de Finsweet!

Biblioteca de plugins e integraciones
Más información
Pestañas de Webflow

Pestañas de Webflow

Conecta las pestañas de Webflow con colecciones CMS, Finsweet Attributes y JavaScript personalizado para crear interfaces dinámicas con pestañas que incluyan contenido generado por el CMS, enlaces profundos y rotación automática.

Biblioteca de plugins e integraciones
Más información
Librería CMS: Anclaje

Librería CMS: Anclaje

¡Crea enlaces de anclaje y secciones en tu CMS con la librería CMS de Finsweet!

Biblioteca de plugins e integraciones
Más información
Biblioteca CMS: Combinar

Biblioteca CMS: Combinar

¡Combina varias listas dinámicas de CMS en una sola lista de colección con la biblioteca CMS de Finsweet!

Biblioteca de plugins e integraciones
Más información
Librería CMS: Añadir clases

Librería CMS: Añadir clases

¡Añade clases personalizadas a los elementos de tu lista de CMS con la librería de Finsweet!

Biblioteca de plugins e integraciones
Más información
Class Adder para Interacciones de Webflow

Class Adder para Interacciones de Webflow

Mantén los scripts existentes de Class Adder para las interacciones de Webflow utilizando el código personalizado del sitio o de la página.

Biblioteca de plugins e integraciones
Más información
Awesome Table

Awesome Table

Conecta Awesome Table con Webflow para mostrar datos de Google Sheets con filtros en cualquier página, sin necesidad de crear un backend personalizado.

Biblioteca de plugins e integraciones
Más información
3D y realidad aumentada con Vectary

3D y realidad aumentada con Vectary

Conecta Vectary, una plataforma de diseño 3D y RA basada en navegador, con Webflow para insertar modelos 3D interactivos y RA sin aplicaciones directamente en tu sitio.

Biblioteca de plugins e integraciones
Más información

Integraciones relacionadas

No se encontraron elementos.

Empieza gratis

Prueba Webflow todo el tiempo que quieras con nuestro plan Starter gratuito. Compra un plan de sitio de pago para publicar, alojar y desbloquear funciones adicionales.

Empieza, es gratis