Borradores de changelog desde GitHub

Conecta un repo de GitHub para que Feedjolt convierta las fusiones de la semana en un borrador de changelog orientado al cliente. Tú editas. Tú publicas.

Los borradores de changelog desde GitHub están en Startup y Scale (no en Growth) - la misma puerta que Slack.

Esto no es la sincronización de GitHub Issues. Issues sigue en la hoja de ruta pública.

Qué hace

• Conecta un repositorio por espacio de trabajo con OAuth de GitHub.
• Borrador por ventana - desde el último changelog publicado, o un rango de fechas (máximo 90 días).
• Una sola entrada en borrador - título propuesto y viñetas para clientes. No un volcado de commits.
• Enlaces opcionales a posts - si el título de una pull request o un commit encaja con un post de feedback, Feedjolt lo vincula. No crea un post por commit.
• Tú publicas - correos y webhooks solo al publicar, igual que cualquier otra entrada.
• Lista de fuentes para el equipo - el editor muestra qué commits y pull requests dieron forma al borrador. Los clientes no ven esa lista.

Feedjolt no publica solo.

Instalar

1. Abre Panel -> Integraciones (/es/dashboard/integrations).
2. En la tarjeta GitHub, pulsa Conectar GitHub. En Growth verás un candado y un aviso para subir de plan.
3. Aprueba el permiso de OAuth. GitHub pide acceso repo para poder leer repositorios privados. Feedjolt solo lee commits y pull requests.
4. Elige el repositorio del producto que usan tus clientes.
5. Pulsa Guardar repositorio.

La página después del OAuth es Panel -> Integraciones -> GitHub.

Crear la OAuth App de GitHub (local o autoalojado)

En Feedjolt alojado la app ya existe. Crea una solo si ejecutas Feedjolt tú.

Usa una OAuth App clásica, no una GitHub App. Feedjolt llama a https://github.com/login/oauth/authorize.

1. Entra en GitHub. Abre Developer settings → OAuth Apps (o Settings → Developer settings → OAuth Apps de tu organización).
2. Pulsa New OAuth App.
3. Rellena:
   • Application name — p. ej. Feedjolt local.
   • Homepage URL — el origen del frontend. En local: http://localhost:3000. En producción: tu FRONTEND_URL / NEXT_PUBLIC_APP_URL.
   • Authorization callback URL — {ese origen}/auth/github/callback. En local: http://localhost:3000/auth/github/callback. Feedjolt en producción: https://www.feedjolt.com/auth/github/callback. Tiene que coincidir con el origen del navegador (localhost, no 127.0.0.1; www.feedjolt.com, no el apex ni api.feedjolt.com).
4. Registra la aplicación. Copia el Client ID.
5. Pulsa Generate a new client secret. Copia el secreto una vez. GitHub no lo vuelve a mostrar.

Pon los valores en el entorno (el mismo Client ID en los dos archivos; el secreto solo en el backend):

# backend/.env
GITHUB_CLIENT_ID="Iv1...."
GITHUB_CLIENT_SECRET="...."

# frontend/.env.local  (se incrusta al arrancar o construir Next)
NEXT_PUBLIC_GITHUB_CLIENT_ID="Iv1...."

Reinicia el backend. Reinicia o reconstruye el frontend si cambias NEXT_PUBLIC_*. Luego conecta en Panel → Integraciones → GitHub.

La app pide el alcance repo para leer repositorios privados. Feedjolt solo lee commits y pull requests. Nunca escribe en el repo. No hace falta Device Flow.

Para rotar el secreto, genera uno nuevo en la misma OAuth App y actualiza GITHUB_CLIENT_SECRET. Los tokens de los espacios siguen hasta que caduquen o alguien desconecte.

Redactar una entrada

1. Panel -> Changelog -> Borrador desde GitHub (o Nueva entrada y luego Borrador desde GitHub).
2. Elige Desde el último changelog publicado o un rango de fechas.
3. Quédate en la página. Redactar puede tardar uno o dos minutos. Feedjolt abre el Borrador cuando está listo. No publica.
4. Edita título y cuerpo. Activa Vista previa para revisar el Markdown. Revisa los posts vinculados. Mira la lista de fuentes de GitHub (solo el equipo).
5. Pulsa Publicar cuando el texto esté listo.

Si aún no hay un changelog publicado, elige un rango. Una ventana vacía (sin pull requests fusionadas ni commits) no crea nada.

Cambiar el repositorio

No hace falta desconectar para cambiar de repo.

1. Panel -> Integraciones -> GitHub.
2. Elige otro repositorio.
3. Pulsa Guardar repositorio.

El siguiente Borrador desde GitHub lee el repo nuevo. Los borradores antiguos conservan su lista de fuentes.

Desconecta y vuelve a conectar si necesitas otra cuenta de GitHub, o si el token caducó. Desconectar corta los borradores nuevos. Las entradas de changelog se quedan.

Cuándo Feedjolt lee git

Nunca con un calendario. No hay webhook, ni un job nocturno, ni un borrador automático al fusionar.

Feedjolt lee commits y pull requests fusionadas solo cuando un admin pulsa Borrador desde GitHub. Ritmo habitual: después de un lanzamiento, o una vez por semana.

• Desde el último changelog publicado - todo lo fusionado después de esa publicación.
• Rango de fechas - las fechas que elijas (máximo 90 días).

Si no hay nada fusionado en esa ventana, no se crea borrador.

Permisos que pide GitHub

Desconecta cuando quieras en Panel -> Integraciones -> GitHub -> Desconectar. Los borradores de changelog se quedan. La lista de fuentes de esos borradores también.

Qué ven los clientes

El changelog público, el RSS, los correos y los webhooks siguen el camino de publicación de siempre. Los hashes, los números de PR y la lista de fuentes no aparecen en el portal.

Limitaciones

• Un repo por espacio para los borradores.
• Solo GitHub. Otros sistemas de control de versiones quedan fuera.
• Sin publicación automática. Una persona tiene que pulsar Publicar.
• No es sync de Issues. Enlazar posts de Feedjolt a GitHub Issues es otro tracker, aún no enviado.

Ver changelog para escribir, programar y RSS.