---
title: Cómo funciona Jamdesk
description: "Git push a docs en vivo en menos de 60 segundos. Aprende cómo Jamdesk construye, despliega y optimiza tu sitio de documentación sin infraestructura propia."
---

Jamdesk construye sitios de documentación a partir de archivos MDX en tu repositorio de GitHub. Escribes Markdown con componentes React, haces push a GitHub, y tu sitio está en vivo en un CDN global en menos de 60 segundos. Tu contenido permanece en tu repositorio como archivos planos. Nada propietario, nada de lo que migrar.

## Descripción general de la arquitectura

Tu repositorio es la fuente de verdad. Jamdesk se conecta a él, construye tu sitio y lo despliega en una red global de edge. No gestionas ninguna infraestructura.

<Frame caption="Cómo fluye el contenido desde tu repositorio hasta tus usuarios">
  <Mermaid minWidth="700px">
{`%%{init: {'theme': 'neutral', 'themeVariables': {'background': 'transparent'}, 'flowchart': {'nodeSpacing': 25, 'rankSpacing': 40, 'curve': 'basis', 'useMaxWidth': false}}}%%
flowchart LR
    subgraph Source["Your Repository"]
        A[("MDX Files")]
        B[("docs.json")]
    end

    subgraph Build["Build Phase"]
        C["Validate"]
        D["Process"]
    end

    E[("CDN Storage")]

    subgraph Serve["Serve Phase"]
        F["Render on Request"]
        G["Edge Cache"]
    end

    Source -->|"git push"| C
    C --> D
    D -->|"Upload"| E
    E --> F
    F --> G
    G -->|"< 50ms"| H["Your Users"]`}
  </Mermaid>
</Frame>

## El pipeline de build

Normalmente 30–60 segundos, de principio a fin. Los builds son rápidos porque Jamdesk no pre-renderiza páginas. Tu contenido sin procesar va al edge, y las páginas se renderizan bajo demanda cuando los visitantes las solicitan.

<Steps>
  <Step title="Obtención del código fuente">
    Haces push a tu rama de GitHub conectada (o pulsas Rebuild en el dashboard). Jamdesk clona tu repositorio y encuentra tu directorio de documentación.
  </Step>
  <Step title="Validación">
    Tu configuración `docs.json` se valida contra el esquema, y los enlaces internos se comprueban en busca de páginas rotas y anclas incorrectas.
  </Step>
  <Step title="Procesamiento de contenido">
    Jamdesk genera tu índice de búsqueda, embeddings del [chat de IA](/es/ai/chat), el sitemap, [`llms.txt`](/es/ai/llms-txt) y las reglas de redirección a partir de tu contenido.
  </Step>
  <Step title="Desplegar al edge">
    El contenido se sube al CDN y se propaga a más de 300 ubicaciones de edge. Solo se transfieren los archivos modificados, por lo que los redespliegues son rápidos.
  </Step>
</Steps>

## Incluido en cada sitio

Todo esto viene gratis con cada sitio. Sin nada que configurar.

<Columns cols={2}>
  <Card title="Búsqueda con IA" icon="magnifying-glass" href="/es/ai/chat">
    Búsqueda en lenguaje natural que entiende la intención, no solo palabras clave. Impulsada por embeddings vectoriales generados a partir de tu contenido durante el build.
  </Card>
  <Card title="llms.txt" icon="robot" href="/es/ai/llms-txt">
    Índice legible por IA siguiendo la especificación de llmstxt.org. Los asistentes de programación y los agentes de IA pueden consumir tu documentación directamente.
  </Card>
  <Card title="SEO esencial" icon="chart-line">
    Sitemap, robots.txt, imágenes Open Graph y metaetiquetas. Tu documentación es indexable desde el primer despliegue.
  </Card>
  <Card title="Analítica integrada" icon="chart-bar" href="/es/setup/analytics-overview">
    dashboard de analítica centrado en la privacidad sin necesidad de cookies. O trae el tuyo propio: admite Google Analytics, Plausible, PostHog y más.
  </Card>
</Columns>

## Qué desencadena un build

Un git push a tu rama conectada, el botón Rebuild en el dashboard, o [`jamdesk deploy`](/es/cli/deploy) desde el CLI. Si haces push de varios commits en rápida sucesión, Jamdesk los agrupa en un único build para no malgastar recursos.

Para detalles operativos (monitoreo de estado, reversiones, variables de entorno, despliegues por rama), consulta [Ciclo de vida de build y despliegue](/es/deploy/lifecycle).

## Seguridad e infraestructura

No necesitas preocuparte por esto, pero si tu equipo de seguridad pregunta: los builds se ejecutan en contenedores aislados y la conexión de tu GitHub App es de solo lectura.

<Columns cols={2}>
  <Card title="Permisos mínimos" icon="shield-check">
    La GitHub App solo solicita acceso de lectura a los repositorios que selecciones. Sin acceso de escritura, sin permisos a nivel de organización.
  </Card>
  <Card title="Builds aislados" icon="box">
    Cada build obtiene su propio contenedor que se destruye tras el despliegue. Nada persiste entre builds ni entre clientes.
  </Card>
  <Card title="HTTPS en todas partes" icon="lock">
    Certificados SSL automáticos para dominios personalizados y subdominios. Sin gestión manual de certificados.
  </Card>
  <Card title="CDN global" icon="globe">
    Servido desde la red de Cloudflare con más de 300 ubicaciones de edge y un 99.9% de tiempo de actividad.
  </Card>
</Columns>

## Rendimiento

Que tu documentación sea encontrada depende en parte de lo rápido que cargue. Google usa [Core Web Vitals](https://www.jamdesk.com/blog/why-google-pagespeed-matters) como señal de clasificación, y los rastreadores de IA como GPTBot y ClaudeBot se dan 1–5 segundos por página. Si tu documentación no carga en ese tiempo, no será citada.

Cada sitio Jamdesk se sirve desde el edge con un tiempo hasta el primer byte inferior a 50 ms. Suficientemente rápido para Google, suficientemente rápido para que los rastreadores de IA lo citen.

| Métrica | Valor típico |
|--------|---------------|
| Tiempo de build | 30-60 segundos |
| Propagación del despliegue | < 30 segundos |
| Primer byte (edge) | < 50ms |
| Carga completa de página | < 500ms |

## Próximos pasos

<Columns cols={3}>
  <Card title="Crear un proyecto" icon="plus" href="/es/setup/creating-projects">
    Configura un nuevo sitio de documentación en el dashboard
  </Card>
  <Card title="Conectar GitHub" icon="github" href="/es/setup/connecting-github">
    Vincula tu repositorio para habilitar los builds automáticos
  </Card>
  <Card title="Preview local" icon="terminal" href="/es/cli/overview">
    Usa el CLI de Jamdesk para hacer preview y validar tu documentación antes de hacer push
  </Card>
</Columns>