# Sincronización con GitHub

Conecta GitHub con un código de dispositivo o un token, publica un proyecto como repositorio nuevo o existente, sube y descarga cambios entre equipos, y cómo se protege tu token.

La sincronización con GitHub es una copia de seguridad opcional fuera de tu equipo y un traspaso entre varios equipos, construida sobre el [repositorio de Git real](/docs/git-history/) que ya es cada proyecto. Los commits locales funcionan sin GitHub. Cuando te conectas, sigue sin haber una cuenta de Oleafly: solo tu GitHub.

## Conecta tu cuenta

En Ajustes, **Integraciones**, **GitHub**, y luego cualquiera de las dos rutas:

- **Conectar GitHub** (recomendado): un flujo con código de dispositivo. Oleafly muestra un código corto, tu navegador abre `github.com/login/device` (con un botón **Copiar** para el código), tú apruebas y la app lo detecta en unos segundos. La conexión solo solicita los permisos `repo` y `read:user`.
- **Token de acceso personal**: despliega "Avanzado: usar un token de acceso personal" y pega un PAT si prefieres generar tus propias credenciales.

Una vez conectado, tu avatar y tu nombre de usuario aparecen en Ajustes y en el menú de GitHub de la barra de herramientas superior. **Desconectar** olvida el token.

### Cómo se protege tu token

El token se guarda en un archivo local cifrado con AES-256-GCM y restringido a su propietario, y nunca se entrega a la capa de interfaz de la app; la interfaz solo llega a saber "conectado como @tú". Cuando Git necesita autenticarse, el token se inyecta mediante un asistente de credenciales en memoria, de modo que nunca aparece en una línea de comandos, en `.git/config` ni en el historial de tu shell. Las compilaciones antiguas que incrustaban tokens en las URL de los remotos se limpian automáticamente al iniciar.

## Publica un proyecto

En el panel del Control de versiones, haz clic en **Publicar en GitHub**:

- **Crear un repositorio nuevo**: elige un nombre (rellenado de antemano a partir del proyecto), deja marcada o desmarcada la casilla **Privado** (recomendado dejarla marcada) y pulsa **Crear y subir**. Oleafly crea el repositorio, confirma los archivos del proyecto, configura `origin` y sube.
- **Enlazar uno existente**: elige en una lista con búsqueda de tus repositorios (los privados muestran un candado) y pulsa **Enlazar y subir**.

Después de publicar, el menú de GitHub de la barra de herramientas ofrece **Abrir en GitHub** y **Copiar el enlace del repositorio**.

### Los archivos que parecen secretos se quedan en local

Publicar nunca confirma archivos que suelen contener claves o contraseñas, como `.env`, `*.pem`, claves privadas SSH o `credentials.json`. Se quedan en la carpeta del proyecto, sin preparar, y el diálogo los nombra. Para publicar uno de todos modos, prepáralo y confírmalo tú mismo en el Control de versiones. Las plantillas como `.env.example`, las claves públicas y los archivos `.key` de Keynote se publican como siempre.

Una subida envía todo el historial. Si alguna vez se confirmó un archivo con uno de estos nombres, Oleafly lo enumera y espera a que elijas **Cancelar** o **Publicar de todos modos** antes de crear nada en GitHub.

## Sincronización del día a día

Los botones **Subir** y **Descargar** del panel del Control de versiones hacen lo que dicen, contra `origin` en tu rama actual. **Traer** y **Sincronizar** están en el menú **Más acciones del control de versiones**, y **Confirmar y subir** y **Confirmar y sincronizar** están en el menú junto a **Confirmar**. El indicador de **por delante/por detrás** (↑ ↓) junto a la etiqueta de la rama te avisa cuando hay algo que subir o descargar.

### Dos equipos

1. En el equipo A: publica el proyecto, trabaja y usa **Subir**.
2. En el equipo B: conecta la misma cuenta de GitHub y luego elige **Importar un proyecto → GitHub** y selecciona el repositorio. Consulta la [guía de importación](/docs/import-project/#import-from-github). A partir de ahí: **Descargar**, trabaja y **Subir**.
3. De vuelta en A: usa **Descargar** antes de empezar. El indicador te lo recuerda.

El color de portada, la elección del documento principal y el historial viajan con el proyecto, porque viven en la propia carpeta del proyecto.

## Cambiar de opinión

Una vez que hay un remoto configurado, el menú **Más acciones del control de versiones** tiene dos elementos más:

- **Cambiar de repositorio** vuelve a abrir el diálogo de publicación para apuntar `origin` a otro lugar.
- **Desenlazar** quita el remoto; el proyecto local y su historial quedan intactos.

## Conflictos y ramas

Si una descarga produce un conflicto de fusión, el Control de versiones enumera los archivos en conflicto. Elige **Usar la actual** o **Usar la entrante** para cada uno, o edita el archivo y elige **Marcar como resuelto**, y luego **Completar la fusión**. **Cancelar la fusión** devuelve los archivos a como estaban. Subir y descargar funcionan en la rama que tienes activa, y el menú de ramas en la parte superior del panel cambia o crea ramas. Consulta [Git y control de versiones](/docs/git-history/#branches-and-stashes).

## Límites, dichos con claridad

Oleafly autentica los remotos HTTPS. Publicar configura uno correctamente por ti.

## Si algo falla

- "No remote 'origin'": publica primero; Subir y Descargar necesitan un remoto.
- Subida rechazada porque el remoto tiene commits: descarga primero y luego sube.
- "No GitHub token set": conéctate en Ajustes, Integraciones, GitHub.

Más información en las [preguntas frecuentes](/docs/faq/#history-and-collaboration).
