---
title: Tutorial completo
description: De un repositorio vacío a un sitio de documentación en vivo -- crea un proyecto, haz preview local, despliega y configura un dominio personalizado.
---

Pasa de un repositorio vacío a un sitio de documentación en vivo. Añade un dominio personalizado cuando estés listo y salta cualquier paso que ya hayas completado.

## Requisitos previos

- Una cuenta de GitHub
- Un repositorio con contenido de documentación (o usa la [Plantilla de inicio](https://github.com/jamdesk/starter-docs))
- Node.js 20+ si quieres instalar el CLI con npm

<Steps>
  <Step title="Crea un proyecto y conecta GitHub">
    Crea tu primer proyecto en el dashboard de Jamdesk y conecta un repositorio.

    - Sigue [Creación de proyectos](/es/setup/creating-projects) para definir el nombre del proyecto, el slug y la ruta de documentación
    - Si se te solicita, instala la aplicación de GitHub y concede acceso al repositorio ([Conectar GitHub](/es/setup/connecting-github))
  </Step>

  <Step title="Edita y previsualiza páginas con el CLI">
    Usa el CLI de Jamdesk para hacer preview de los cambios en las páginas antes de enviarlos a GitHub.

    <Tabs>
      <Tab title="npm">
        ```bash
        npm install -g jamdesk
        cd your-docs
        jamdesk dev
        ```
      </Tab>
      <Tab title="npx">
        ```bash
        cd your-docs
        npx jamdesk dev
        ```
      </Tab>
    </Tabs>

    Tu preview local está disponible en **http://localhost:3000**. Más información en [Preview local](/es/development/local-preview).

    Abre una página `.mdx` en tu editor, guarda un cambio y actualiza el preview local. Cuando el resultado sea el esperado, publícalo con el flujo de Git del siguiente paso.
  </Step>

  <Step title="Despliega enviando cambios a GitHub">
    Cada push a tu rama configurada dispara un build y publica en tu subdominio de Jamdesk.

    ```bash
    git add .
    git commit -m "Add docs content"
    git push origin main
    ```

    Reemplaza `main` por la rama configurada en tu proyecto si utilizas una rama diferente.

    Cuando finalice el build, tu documentación estará en vivo en `your-project.jamdesk.app`. Consulta [Despliegue](/es/development/deployment) para más detalles.
  </Step>

  <Step title="Opcional: Añade un dominio personalizado">
    Deja tu documentación lista para producción con tu propio dominio cuando estés preparado para usarla fuera del subdominio de Jamdesk.

    1. Ve a **Settings** → **Domains** en el dashboard de Jamdesk
    2. Añade tu dominio (por ejemplo, `docs.example.com`)
    3. Crea los registros DNS que se muestran en el dashboard
    4. Espera a que se completen la verificación y el SSL

    Para resolución de problemas, consulta [Dominios personalizados](/es/deploy/custom-domains).
  </Step>
</Steps>

## Valida el flujo completo

- Tu subdominio de Jamdesk carga y muestra el último build
- El preview local refleja el mismo contenido y navegación
- Si está configurado, el dominio personalizado está verificado y sirve HTTPS
- El historial de builds muestra el último commit y la atribución del autor

## Opcional: Alojar en /docs

Si quieres la documentación en una subruta como `example.com/docs`, revisa [Resumen de despliegue](/es/deploy/overview) y [Alojamiento en subruta](/es/deploy/subpath-hosting).

## ¿Qué sigue?

<Columns cols={2}>
  <Card title="Crear un proyecto" icon="plus" href="/es/setup/creating-projects">
    Gestiona la configuración y las plantillas del proyecto
  </Card>
  <Card title="Resumen del CLI" icon="terminal" href="/es/cli/overview">
    Instala el CLI y consulta los comandos disponibles
  </Card>
  <Card title="Resumen de despliegue" icon="cloud-arrow-up" href="/es/deploy/overview">
    Compara las opciones de alojamiento
  </Card>
  <Card title="Dominios personalizados" icon="globe" href="/es/deploy/custom-domains">
    Verifica el DNS y soluciona problemas de configuración
  </Card>
</Columns>