---
title: Preview locale
description: Le CLI Jamdesk vous permet de prévisualiser votre documentation sur votre machine avant de pousser en production. Les modifications apparaissent instantanément lors de l'édition.
---

Exécutez `jamdesk dev` (ou `npx jamdesk dev`) depuis tout répertoire contenant un fichier `docs.json` pour démarrer un serveur local avec rechargement à chaud, recherche complète et tous les composants fonctionnant exactement comme en production.

## Prérequis

Avant de commencer, assurez-vous de disposer de :

- **Node.js 20+** - Vérifiez avec `node --version`
- **Un projet de documentation** - Avec un fichier de configuration `docs.json`

## Démarrer le serveur de développement

<Tabs>
  <Tab title="npm (Installation globale)">
    Installez le CLI globalement, puis exécutez-le depuis votre répertoire de documentation :

    ```bash
    npm install -g jamdesk
    cd your-docs
    jamdesk dev
    ```
  </Tab>
  <Tab title="npx (Sans installation)">
    Exécutez directement sans installation :

    ```bash
    cd your-docs
    npx jamdesk dev
    ```
  </Tab>
</Tabs>

Votre documentation sera disponible à l'adresse **http://localhost:3000**

## Ce que vous obtenez

<Columns cols={2}>
  <Card title="Rechargement à chaud" icon="bolt">
    Modifiez les fichiers MDX et visualisez les changements instantanément. Les modifications apportées à docs.json et à votre `style.css` sont prises en compte au rechargement.
  </Card>
  <Card title="Recherche complète" icon="magnifying-glass">
    Testez la recherche Cmd+K avec votre contenu réel
  </Card>
  <Card title="Tous les composants" icon="puzzle-piece">
    Chaque composant fonctionne exactement comme en production
  </Card>
  <Card title="Changement de thème" icon="moon">
    Testez les modes clair et sombre
  </Card>
</Columns>

## Port personnalisé

Le port par défaut est 3000. S'il est déjà utilisé, spécifiez-en un autre :

```bash
jamdesk dev --port 3001
```

Ou définissez un port par défaut permanent dans `~/.jamdeskrc` :

```json
{
  "defaultPort": 3001
}
```

## Mode verbose

Affichez des informations de build détaillées avec le flag `--verbose` :

```bash
jamdesk dev --verbose
```

Cela affiche :
- La détection des modifications de fichiers
- Les durées de build
- L'analyse de la navigation
- Les avertissements ou erreurs

## Performances au premier démarrage

<Note>
La première fois que vous exécutez `jamdesk dev`, les dépendances sont installées dans `~/.jamdesk`. Cela prend 30 à 60 secondes. Les démarrages suivants s'effectuent en moins de 5 secondes.
</Note>

Pour vider le cache et forcer une nouvelle installation :

```bash
jamdesk clean
jamdesk dev
```

## Dépannage

<AccordionGroup>
  <Accordion title="Port déjà utilisé">
    Un autre processus utilise le port 3000.

    **Option 1 :** Utilisez un port différent
    ```bash
    jamdesk dev --port 3001
    ```

    **Option 2 :** Trouvez et arrêtez le processus
    ```bash
    lsof -i :3000
    kill -9 <PID>
    ```
  </Accordion>

  <Accordion title="docs.json introuvable">
    Assurez-vous de vous trouver dans le répertoire contenant votre fichier `docs.json` :

    ```bash
    ls docs.json  # Should show the file
    jamdesk dev
    ```
  </Accordion>

  <Accordion title="Les modifications n'apparaissent pas">
    Essayez ces étapes :
    1. Vérifiez les erreurs dans le terminal
    2. Effectuez un rechargement forcé du navigateur (Cmd+Shift+R)
    3. Redémarrez le serveur de développement
    4. Exécutez `jamdesk clean` et réessayez
  </Accordion>

  <Accordion title="Démarrage lent">
    Exécutez les diagnostics :
    ```bash
    jamdesk doctor
    ```

    Cette commande vérifie votre environnement et identifie les problèmes.
  </Accordion>
</AccordionGroup>

## Et ensuite ?

<Columns cols={2}>
  <Card title="Extension VS Code" icon="window" href="/fr/development/vscode-extension">
    Démarrez le serveur de développement depuis la barre de statut de VS Code
  </Card>
  <Card title="Déploiement" icon="rocket" href="/fr/development/deployment">
    Découvrez le processus de build et de déploiement
  </Card>
</Columns>