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

# Prévisualisation locale

> Lancez une prévisualisation locale de votre site Mintlify avec rechargement en direct, recherche plein texte et support de l'assistant IA via mint dev.

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

* La [CLI Mintlify](/fr/cli/install) installée globalement, ou exécutez les commandes avec `npx mint`.
* Un répertoire de documentation contenant un fichier `docs.json` valide.

<div id="start-the-local-preview">
  ## Démarrer la prévisualisation locale
</div>

Naviguez jusqu'au répertoire de votre documentation contenant votre fichier `docs.json` et exécutez :

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

La prévisualisation locale démarre à l'adresse `http://localhost:3000`. Au fur et à mesure que vous modifiez, les changements apparaissent en temps réel.

Par défaut, la prévisualisation s'ouvre automatiquement dans votre navigateur. Pour empêcher l'ouverture du navigateur, utilisez le flag `--no-open` :

```bash theme={null}
mint dev --no-open
```

Pour générer une prévisualisation sans installer la CLI globalement, exécutez :

```bash theme={null}
npx mint dev
```

<div id="log-in-for-search-and-assistant">
  ## Se connecter pour la recherche et l'assistant
</div>

Vous devez authentifier la CLI avec votre compte Mintlify pour activer la recherche et l'[assistant](/fr/assistant/index).

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

Après vous être authentifié avec la commande `mint login`, la CLI stocke vos identifiants dans `~/.config/mintlify/config.json` afin que vous restiez connecté entre les sessions. La CLI vous invite également à sélectionner un projet par défaut, que des commandes comme `mint automations` utilisent.

Une fois connecté, exécutez `mint dev` pour démarrer la prévisualisation locale avec la recherche et l'assistant activés. L'assistant utilise le même contenu indexé que votre site de documentation déployé.

Pour vérifier l'état de votre authentification, exécutez :

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

Pour vous déconnecter, exécutez :

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

<div id="custom-ports">
  ## Ports personnalisés
</div>

Par défaut, la CLI utilise le port 3000. Pour utiliser un port différent, utilisez le flag `--port` :

```bash theme={null}
mint dev --port 3333
```

Si le port est déjà utilisé, la CLI essaie automatiquement le port disponible suivant.

<div id="skip-openapi-processing">
  ## Ignorer le traitement OpenAPI
</div>

Si vous avez de nombreux fichiers OpenAPI, ignorez le traitement OpenAPI pendant le développement local pour améliorer les performances avec le flag `--disable-openapi` :

```bash theme={null}
mint dev --disable-openapi
```

<div id="preview-as-a-specific-group">
  ## Prévisualiser en tant que groupe spécifique
</div>

Si vous utilisez le contrôle d'accès basé sur les groupes, prévisualisez en tant que groupe d'authentification spécifique avec le flag `--groups` :

```bash theme={null}
mint dev --groups admin
```

Consultez [Configuration de l'authentification](/fr/deploy/authentication-setup#control-access-with-groups) pour plus d'informations sur les groupes.