---
title: Come funziona Jamdesk
description: Dal push Git alla documentazione online in meno di 60 secondi. Scopri come Jamdesk crea, distribuisce e ottimizza il tuo sito senza infrastruttura da gestire.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Jamdesk crea siti di documentazione dai file MDX nel tuo repository GitHub. Scrivi Markdown con componenti React, esegui il push su GitHub e il tuo sito sarà online su un CDN globale in meno di 60 secondi. I contenuti restano nel repository come semplici file MDX, quindi puoi trasferirli a un altro strumento in qualsiasi momento.

## Panoramica dell'architettura

Il tuo repository è la fonte autorevole. Jamdesk si connette al repository, crea il sito e lo distribuisce su una rete edge globale. Non devi gestire alcuna infrastruttura.

<Frame caption="Come fluiscono i contenuti dal tuo repository ai tuoi utenti">
  <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>

## La pipeline di build

In genere richiede 30-60 secondi dall'inizio alla fine. I build sono rapidi perché Jamdesk non esegue il pre-rendering delle pagine. I contenuti grezzi vengono inviati all'edge e le pagine vengono renderizzate su richiesta quando i visitatori le richiedono.

<Steps>
  <Step title="Recupero della sorgente">
    Esegui il push sul branch GitHub connesso (oppure seleziona Rebuild nel dashboard). Jamdesk clona il repository e individua la directory della documentazione.
  </Step>
  <Step title="Convalida">
    La configurazione `docs.json` viene convalidata rispetto allo schema e i link interni vengono controllati per individuare pagine inesistenti e anchor non validi.
  </Step>
  <Step title="Elaborazione dei contenuti">
    Jamdesk genera l'indice di ricerca, gli embedding per la [chat AI](/it/ai/chat), la sitemap, [`llms.txt`](/it/ai/llms-txt) e le regole di reindirizzamento dai tuoi contenuti.
  </Step>
  <Step title="Deploy sull'edge">
    I contenuti vengono caricati sul CDN e propagati in oltre 300 località edge. Vengono trasferiti solo i file modificati, quindi i nuovi deploy sono rapidi.
  </Step>
</Steps>

## Incluso in ogni sito

Ogni sito include queste funzionalità per impostazione predefinita. Non è richiesta alcuna configurazione.

<Columns cols={2}>
  <Card title="Ricerca AI" icon="magnifying-glass" href="/it/ai/chat">
    Ricerca in linguaggio naturale che comprende l'intento, non solo le parole chiave. Utilizza embedding vettoriali generati dai tuoi contenuti durante il build.
  </Card>
  <Card title="llms.txt" icon="robot" href="/it/ai/llms-txt">
    Indice leggibile dall'AI conforme alle specifiche di llmstxt.org. Gli assistenti di programmazione e gli agenti AI possono utilizzare direttamente la tua documentazione.
  </Card>
  <Card title="Elementi essenziali SEO" icon="chart-line">
    Sitemap, robots.txt, immagini Open Graph e meta tag. La tua documentazione è indicizzabile fin dal primo deploy.
  </Card>
  <Card title="Analytics integrato" icon="chart-bar" href="/it/setup/analytics-overview">
    Dashboard di analytics orientato alla privacy, senza cookie obbligatori. Oppure usa il tuo strumento: Jamdesk supporta Google Analytics, Plausible, PostHog e altri.
  </Card>
</Columns>

## Cosa attiva un build

Un push Git sul branch connesso, il pulsante Rebuild nel dashboard oppure [`jamdesk deploy`](/it/cli/deploy) dalla CLI. Se esegui il push di più commit in rapida successione, Jamdesk li raggruppa in un unico build per evitare di consumare risorse inutilmente.

Per i dettagli operativi (monitoraggio dello stato, rollback, variabili d'ambiente e deploy dei branch), consulta [Ciclo di build e deploy](/it/deploy/lifecycle).

## Sicurezza e infrastruttura

Non devi occuparti di questi aspetti, ma se il tuo team di sicurezza lo chiede: i build vengono eseguiti in container isolati e la connessione alla tua GitHub App è di sola lettura.

<Columns cols={2}>
  <Card title="Permessi minimi" icon="shield-check">
    La GitHub App richiede solo l'accesso in lettura ai repository selezionati. L'app non dispone dell'accesso in scrittura e non richiede ambiti a livello dell'intera organizzazione.
  </Card>
  <Card title="Build isolati" icon="box">
    Ogni build viene eseguito nel proprio container, che viene eliminato dopo il deploy. Nulla persiste tra build o clienti diversi.
  </Card>
  <Card title="HTTPS ovunque" icon="lock">
    Certificati SSL automatici per domini personalizzati e sottodomini. I certificati vengono emessi e rinnovati automaticamente.
  </Card>
  <Card title="CDN globale" icon="globe">
    I contenuti vengono distribuiti dalla rete di Cloudflare, con oltre 300 località edge e un uptime del 99,9%.
  </Card>
</Columns>

## Prestazioni

La possibilità che la tua documentazione venga trovata dipende anche dalla velocità di caricamento. Google utilizza i [Core Web Vitals](https://jamdesk.com/blog/why-google-pagespeed-matters) come segnale di ranking e i crawler AI come GPTBot e ClaudeBot si concedono da 1 a 5 secondi per pagina. Se la documentazione non si carica entro questo intervallo, non verrà citata.

Ogni sito Jamdesk viene distribuito dall'edge con un tempo al primo byte inferiore a 50 ms. È sufficientemente veloce per le soglie di ranking di Google e consente ai crawler AI di recuperare e citare i contenuti.

| Metrica | Valore tipico |
|--------|---------------|
| Durata del build | 30-60 secondi |
| Propagazione del deploy | < 30 secondi |
| Primo byte (edge) | < 50 ms |
| Caricamento completo della pagina | < 500 ms |

## Prossimi passaggi

<Columns cols={3}>
  <Card title="Crea un progetto" icon="plus" href="/it/setup/creating-projects">
    Configura un nuovo sito di documentazione nel dashboard
  </Card>
  <Card title="Connetti GitHub" icon="github" href="/it/setup/connecting-github">
    Collega il tuo repository per abilitare i build automatici
  </Card>
  <Card title="Anteprima locale" icon="terminal" href="/it/cli/overview">
    Usa la CLI di Jamdesk per visualizzare in anteprima e convalidare la documentazione prima del push
  </Card>
</Columns>