> ## Documentation Index
> Fetch the complete documentation index at: https://smartac-mintlify-04d11f81.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installer la CLI

> Installez la CLI Mintlify pour prévisualiser la documentation localement, tester les modifications en direct et détecter les erreurs avant le déploiement.

<div id="prerequisites">
  ## Prérequis
</div>

* [Node.js](https://nodejs.org/en) v20.17.0+ (versions LTS recommandées)

<div id="install-the-cli">
  ## Installer la CLI
</div>

<CodeGroup>
  ```bash npm theme={null}
  npm i -g mint
  ```

  ```bash pnpm theme={null}
  pnpm add -g mint
  ```
</CodeGroup>

<div id="create-a-new-project">
  ## Créer un nouveau projet
</div>

Pour créer un nouveau projet de documentation à partir du modèle de démarrage Mintlify, exécutez la commande suivante :

```bash theme={null}
mint new [directory]
```

Si vous ne spécifiez pas de répertoire, la CLI vous invite à créer un nouveau sous-répertoire ou à écraser le répertoire actuel.

<Warning>
  Écraser le répertoire actuel supprime tous les fichiers existants.
</Warning>

| Flag         | Description                                                                       |
| ------------ | --------------------------------------------------------------------------------- |
| `--name`     | Nom du projet. La CLI le demande s'il n'est pas fourni.                           |
| `--theme`    | [Thème](/fr/customize/themes) du projet. La CLI le demande s'il n'est pas fourni. |
| `--template` | Modèle prédéfini. La CLI le demande s'il n'est pas fourni.                        |
| `--force`    | Écraser le répertoire actuel sans confirmation.                                   |

En mode interactif, la CLI demande si vous souhaitez choisir un thème ou cloner un modèle. Pour ignorer l'invite, passez directement le flag `--template` :

```bash theme={null}
mint new my-docs --template <template-name>
```

Vous pouvez combiner `--template` avec `--theme` pour remplacer le thème par défaut du modèle :

```bash theme={null}
mint new my-docs --template <template-name> --theme <theme>
```

Consultez les modèles disponibles dans le dépôt [mintlify/templates](https://github.com/mintlify/templates) sur GitHub. En mode interactif, la CLI récupère et affiche automatiquement les modèles disponibles.

Dans les environnements non interactifs tels que les pipelines CI/CD ou les agents de codage IA, vous devez fournir les flags `--name` et `--theme`, ou le flag `--template`.

<div id="update">
  ## Mise à jour
</div>

Si votre prévisualisation locale n'est pas synchronisée avec votre documentation déployée, mettez à jour la CLI vers la dernière version :

```bash theme={null}
mint update
```

Si `mint update` n'est pas disponible dans votre version, réinstallez la CLI avec la dernière version :

<CodeGroup>
  ```bash npm theme={null}
  npm i -g mint@latest
  ```

  ```bash pnpm theme={null}
  pnpm add -g mint@latest
  ```
</CodeGroup>

<div id="formatting">
  ## Formatage
</div>

Pour la coloration syntaxique et le formatage du code dans les fichiers MDX, nous recommandons les extensions suivantes :

* **Cursor, Windsurf, VS Code** : [Extension MDX pour VS Code](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) et [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode)
* **JetBrains** : [Plugin MDX pour IntelliJ IDEA](https://plugins.jetbrains.com/plugin/14944-mdx) et [Prettier](https://prettier.io/docs/webstorm)

<div id="troubleshooting">
  ## Dépannage
</div>

<AccordionGroup>
  <Accordion title="Error: Could not load the &#x22;sharp&#x22; module using the darwin-arm64 runtime">
    Cela peut être dû à une version obsolète de Node.js. Essayez les étapes suivantes :

    1. Désinstallez la version actuelle de la CLI mint : `npm uninstall -g mint`
    2. Mettez à jour vers Node.js v20.17.0+.
    3. Réinstallez la CLI mint : `npm install -g mint`
  </Accordion>

  <Accordion title="Problème : une erreur inconnue se produit">
    **Solution** : Allez à la racine de votre appareil et supprimez le dossier `~/.mintlify`. Ensuite, exécutez à nouveau `mint dev`.
  </Accordion>

  <Accordion title="Error: permission denied">
    Cela est dû au manque de permissions pour installer des packages Node de manière globale.

    **Solution** : Essayez d'exécuter `sudo npm i -g mint`. Lorsque vous y êtes invité, entrez le mot de passe que vous utilisez pour déverrouiller votre ordinateur.
  </Accordion>

  <Accordion title="La prévisualisation locale ne ressemble pas à la documentation en ligne">
    Cela est probablement dû à une version obsolète de la CLI.

    **Solution** : Exécutez `mint update` pour obtenir les dernières modifications.
  </Accordion>

  <Accordion title="Package mintlify versus mint">
    Si vous rencontrez des problèmes avec le package CLI, exécutez d'abord `npm ls -g` pour voir les packages installés globalement. Si vous n'utilisez pas npm, essayez `which mint` pour localiser l'installation.

    Si vous avez à la fois le package `mint` et le package `mintlify` installés, désinstallez `mintlify` :

    ```bash theme={null}
    npm uninstall -g mintlify
    npm cache clean --force
    npm i -g mint
    ```
  </Accordion>

  <Accordion title="La version du client affiche 'none' après l'installation">
    Si vous exécutez `mint version` et que la version du client s'affiche comme `none`, la CLI peut ne pas être en mesure de télécharger l'application client en raison d'un pare-feu d'entreprise ou d'un VPN.

    **Solution** : Demandez à votre administrateur informatique d'ajouter `releases.mintlify.com` à la liste d'autorisation de votre réseau.
  </Accordion>

  <Accordion title="La CLI se connecte à localhost au lieu de la production lorsqu'on utilise npx">
    Dans les versions antérieures à `4.0.1125`, l'exécution de `npx mint dev` ou d'autres
    commandes depuis un dépôt de documentation pouvait amener la CLI à se détecter
    incorrectement comme une compilation de développement local. La CLI pointait alors vers
    des URLs `localhost` au lieu de l'API de production Mintlify, ce qui entraînait des
    erreurs de connexion ou un comportement inattendu.

    **Solution** : Mettez à jour vers la dernière version de la CLI :

    ```bash theme={null}
    npm i -g mint@latest
    ```
  </Accordion>
</AccordionGroup>