---
title: Comment fonctionne Jamdesk
description: Publiez vos docs en moins de 60 secondes. Découvrez comment Jamdesk build, déploie et optimise votre site de documentation sans infrastructure à gérer.
---

Jamdesk génère des sites de documentation à partir de fichiers MDX dans votre dépôt GitHub. Vous écrivez du Markdown avec des composants React, vous poussez vers GitHub, et votre site est en ligne sur un CDN mondial en moins de 60 secondes. Votre contenu reste dans votre dépôt sous forme de fichiers ordinaires. Rien de propriétaire, rien à migrer.

## Présentation de l'architecture

Votre dépôt est la source de vérité. Jamdesk s'y connecte, génère votre site et le déploie sur un réseau edge mondial. Vous ne gérez aucune infrastructure.

<Frame caption="Comment le contenu circule de votre dépôt à vos utilisateurs">
  <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>

## Le pipeline de build

En général 30 à 60 secondes, du début à la fin. Les builds sont rapides car Jamdesk ne pré-rend pas les pages. Votre contenu brut est envoyé à l'edge, et les pages se rendent à la demande lorsque les visiteurs les consultent.

<Steps>
  <Step title="Récupération des sources">
    Vous poussez vers votre branche GitHub connectée (ou cliquez sur Reconstruire dans le dashboard). Jamdesk clone votre dépôt et localise votre répertoire de documentation.
  </Step>
  <Step title="Validation">
    Votre configuration `docs.json` est validée par rapport au schéma, et les liens internes sont vérifiés pour détecter les pages manquantes et les ancres incorrectes.
  </Step>
  <Step title="Traitement du contenu">
    Jamdesk génère votre index de recherche, les embeddings du [chat IA](/fr/ai/chat), le sitemap, [`llms.txt`](/fr/ai/llms-txt) et les règles de redirection à partir de votre contenu.
  </Step>
  <Step title="Déploiement sur l'edge">
    Le contenu est téléversé sur le CDN et se propage vers 300+ emplacements edge. Seuls les fichiers modifiés sont transférés, ce qui accélère les redéploiements.
  </Step>
</Steps>

## Intégré à chaque site

Tout cela est inclus gratuitement avec chaque site. Rien à configurer.

<Columns cols={2}>
  <Card title="Recherche IA" icon="magnifying-glass" href="/fr/ai/chat">
    Recherche en langage naturel qui comprend l'intention, pas seulement les mots-clés. Alimentée par des embeddings vectoriels générés à partir de votre contenu au moment du build.
  </Card>
  <Card title="llms.txt" icon="robot" href="/fr/ai/llms-txt">
    Index lisible par les IA suivant la spécification llmstxt.org. Les assistants de code et agents IA peuvent consommer directement votre documentation.
  </Card>
  <Card title="Essentiels SEO" icon="chart-line">
    Sitemap, robots.txt, images Open Graph et balises meta. Votre documentation est indexable dès le premier déploiement.
  </Card>
  <Card title="Analytique intégrée" icon="chart-bar" href="/fr/setup/analytics-overview">
    Un dashboard d'analytique axé sur la confidentialité, sans cookies. Ou apportez le vôtre — compatible avec Google Analytics, Plausible, PostHog et bien d'autres.
  </Card>
</Columns>

## Ce qui déclenche un build

Un git push vers votre branche connectée, le bouton Reconstruire dans le dashboard, ou [`jamdesk deploy`](/fr/cli/deploy) depuis le CLI. Si vous poussez plusieurs commits en succession rapide, Jamdesk les regroupe en un seul build pour ne pas gaspiller de ressources.

Pour les détails opérationnels (surveillance du statut, retours en arrière, variables d'environnement, déploiements par branche), consultez [Cycle de vie du build et du déploiement](/fr/deploy/lifecycle).

## Sécurité et infrastructure

Vous n'avez pas à vous soucier de tout cela, mais si votre équipe sécurité le demande : les builds s'exécutent dans des conteneurs isolés et votre connexion GitHub App est en lecture seule.

<Columns cols={2}>
  <Card title="Permissions minimales" icon="shield-check">
    L'application GitHub ne demande que l'accès en lecture aux dépôts que vous sélectionnez. Pas d'accès en écriture, pas de portées à l'échelle de l'organisation.
  </Card>
  <Card title="Builds isolés" icon="box">
    Chaque build dispose de son propre conteneur, détruit après le déploiement. Rien ne persiste entre les builds ou entre les clients.
  </Card>
  <Card title="HTTPS partout" icon="lock">
    Certificats SSL automatiques pour les domaines personnalisés et les sous-domaines. Aucune gestion manuelle des certificats.
  </Card>
  <Card title="CDN mondial" icon="globe">
    Servi depuis le réseau Cloudflare avec 300+ emplacements edge et 99.9 % de disponibilité.
  </Card>
</Columns>

## Performance

La visibilité de votre documentation dépend en partie de sa vitesse de chargement. Google utilise les [Core Web Vitals](https://jamdesk.com/blog/why-google-pagespeed-matters) comme signal de classement, et les crawlers IA comme GPTBot et ClaudeBot s'accordent 1 à 5 secondes par page. Si votre documentation ne se charge pas dans cette fenêtre, elle ne sera pas citée.

Chaque site Jamdesk est servi depuis l'edge avec un temps jusqu'au premier octet inférieur à 50 ms. Suffisamment rapide pour Google, suffisamment rapide pour être cité par les crawlers IA.

| Métrique | Valeur typique |
|--------|---------------|
| Durée du build | 30-60 secondes |
| Propagation du déploiement | < 30 secondes |
| Premier octet (edge) | < 50ms |
| Chargement complet de la page | < 500ms |

## Prochaines étapes

<Columns cols={3}>
  <Card title="Créer un projet" icon="plus" href="/fr/setup/creating-projects">
    Créez un nouveau site de documentation dans le dashboard
  </Card>
  <Card title="Connecter GitHub" icon="github" href="/fr/setup/connecting-github">
    Liez votre dépôt pour activer les builds automatiques
  </Card>
  <Card title="Preview en local" icon="terminal" href="/fr/cli/overview">
    Utilisez le CLI Jamdesk pour prévisualiser et valider votre documentation avant de pousser
  </Card>
</Columns>