Proyectos: publicar desde tu repositorio

Qué consigues: conectas un repositorio de git y, en cada push, tu web se construye y se publica sola. Con HTTPS, sin tocar nada y sin subir ficheros por FTP.

Es lo que quieres si tu web la genera un framework —Astro, Vite, Next exportado, Hugo, Jekyll…— y trabajas con git. Si lo tuyo es WordPress o PHP, eso es Dar de alta una web, no esto.

Crear el primer proyecto

En el menú, Proyectos. La primera vez sólo verás Conectar un repositorio.

En Nuevo proyecto eliges de dónde sale el código:

• Desde tu proveedor de git — conectas GitHub, GitLab o Bitbucket y eliges el repositorio. Cada push a la rama de producción publica una versión nueva.

• O empieza con una plantilla — la copiamos a tu cuenta de git, no a la nuestra, y la desplegamos. El repositorio es tuyo desde el primer minuto. Por eso hace falta conectar el proveedor antes.

Luego eliges dominio, y puedes dejarlo para después: el subdominio gratuito funciona desde el primer despliegue.

El primer despliegue

En cuanto conectas, empieza a construir. En la pantalla del proyecto ves los despliegues, y pinchando en uno, su registro en vivo.

Si falla, el registro se recorta conservando el final, que es donde está el error, y cada error conocido lleva un enlace de Más sobre este error.

Note

No hace falta que aciertes con la configuración. Miramos qué hay en el repositorio y detectamos el framework solo. Lo puedes forzar después en Ajustes.

Tu dominio

En la pestaña Dominios de cada proyecto:

• El subdominio gratuito está siempre y no caduca.

• Añadir un dominio: cómpralo ahí mismo y queda enganchado solo, o apunta el que ya tengas.

Verás el estado en el que va: Verificando DNS, Emitiendo certificado, Activo. No hay que hacer nada entre uno y otro: es esperar.

Un proyecto ya publicado, con su repositorio, el commit y cuánto tardó.

Cambiar cómo se construye

En Ajustes:

Ajuste	Para qué
Framework	Déjalo en Detectar solo (recomendado) salvo que se equivoque.
Rama de producción	Qué rama publica. Las demás no publican nada.
Comando de instalación	Normalmente npm ci. Sólo si el tuyo es otro.
Comando de construcción	Lo que genera la web. Normalmente npm run build.
Directorio de salida	Dónde deja los ficheros. dist en casi todos.
Subcarpeta del repositorio	Si el proyecto no está en la raíz (un monorepo).

Volver atrás

Cada despliegue queda guardado y se puede promocionar a producción. Cuando lo haces, la pantalla avisa: Producción está fijada en un despliegue anterior.

Warning

Mientras esté fijada, un push nuevo no publica. Es a propósito: si no, el siguiente commit deshace tu vuelta atrás sin avisar, con el sitio caído. Para volver a lo normal, promociona el último despliegue.

Variables de entorno

Las que necesite tu build. Se guardan cifradas y no se enseñan una vez guardadas: se pueden reemplazar, no leer.

Problemas frecuentes

Hice push y no ha pasado nada

Mira la rama: sólo publica la de producción. Y comprueba que la conexión con tu proveedor de git sigue autorizada.

Construye bien pero la web sale en blanco

Casi siempre es el Directorio de salida. Mira dónde deja los ficheros tu framework y ponlo en Ajustes.

Quiero el dominio que ya tengo

Añádelo en Dominios y apunta el DNS donde te diga. Si el DNS lo llevas tú, El DNS de tu dominio explica los registros.