---
title: Tu primer build
description: Lo que ocurre después de conectar un repositorio: fases del build, la pestaña Deployments y qué revisar si algo falla.
---

Tu primer build comienza automáticamente cuando conectas un repositorio.

## Builds automáticos

Cuando conectas un repositorio, Jamdesk lanza un build inicial de inmediato. Cada push posterior a tu rama conectada activa un nuevo build automáticamente.

## Progreso del build

Sigue tu build en el dashboard:

<Steps>
  <Step title="En cola">
    Tu build está esperando para iniciarse. En momentos de alta demanda, puede haber una breve espera.
  </Step>
  <Step title="Clonando">
    Jamdesk obtiene el contenido de tu repositorio desde GitHub.
  </Step>
  <Step title="Validando">
    Tu `docs.json` y los archivos MDX se validan en busca de errores.
  </Step>
  <Step title="Construyendo">
    MDX se compila a HTML optimizado con resaltado de sintaxis e indexación de búsqueda.
  </Step>
  <Step title="Desplegando">
    Los archivos generados se suben al CDN global.
  </Step>
  <Step title="En línea">
    Tu documentación está disponible en la URL de tu proyecto.
  </Step>
</Steps>

## Ver tu documentación en línea

Una vez que el build finaliza, haz clic en **View Site** en el dashboard o visita `https://your-project.jamdesk.app`.

Si configuraste un dominio personalizado, tu documentación también estará disponible allí.

## Rebuild manual

¿Necesitas reconstruir sin hacer push de cambios?

1. Ve a tu proyecto en el [dashboard](https://dashboard.jamdesk.com)
2. Abre **Settings**
3. Haz clic en **Rebuild**

Úsalo después de cambiar variables de entorno o para forzar un build limpio.

## Si tu build falla

Los fallos de build muestran un mensaje de error en el dashboard. Causas comunes:

- Sintaxis inválida en `docs.json`
- Errores de sintaxis en MDX
- Páginas referenciadas en la navegación que no existen

<Card title="Referencia de errores de build" icon="circle-exclamation" href="/es/help/troubleshooting/error-reference">
  Consulta los códigos de error más comunes y cómo resolverlos
</Card>

## Artículos relacionados

<Columns cols={2}>
  <Card title="Activar builds" icon="play" href="/es/builds/triggering">
    Aprende sobre los activadores de build automáticos y manuales
  </Card>
  <Card title="Monitorear builds" icon="chart-line" href="/es/builds/monitoring">
    Sigue el progreso del build y consulta los registros
  </Card>
</Columns>