# Previsualización local (/es/cli/preview)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 926 · updated: 2026-07-30 -->
Related: [Instalar la CLI](/es/cli/install.md), [Referencia de comandos de la CLI de Mintlify](/es/cli/commands.md)

<div id="prerequisites">
  ## Requisitos previos [#requisitos-previos]
</div>

* La [CLI de Mintlify](/es/cli/install) instalada globalmente, o ejecuta los comandos con `npx mint`.
* Un directorio de documentación con un archivo `docs.json` válido.

<div id="start-the-local-preview">
  ## Iniciar la previsualización local [#iniciar-la-previsualización-local]
</div>

Navega al directorio de tu documentación que contiene el archivo `docs.json` y ejecuta:

```bash
mint dev
```

La previsualización local se inicia en `http://localhost:3000`. A medida que editas, los cambios aparecen en tiempo real.

Por defecto, la previsualización se abre automáticamente en tu navegador. Para evitar que el navegador se abra, usa el flag `--no-open`:

```bash
mint dev --no-open
```

Para generar una previsualización sin instalar la CLI globalmente, ejecuta:

```bash
npx mint dev
```

<div id="log-in-for-search-and-assistant">
  ## Iniciar sesión para búsqueda y asistente [#iniciar-sesión-para-búsqueda-y-asistente]
</div>

Debes autenticar la CLI con tu cuenta de Mintlify para habilitar la búsqueda y el [asistente](/es/assistant/index).

```bash
mint login
```

Después de autenticarte con el comando `mint login`, la CLI almacena tus credenciales en `~/.config/mintlify/config.json` para que permanezcas conectado entre sesiones. La CLI también te solicita que selecciones un proyecto predeterminado, que comandos como `mint automations` utilizan.

Una vez que hayas iniciado sesión, ejecuta `mint dev` para iniciar la previsualización local con la búsqueda y el asistente habilitados. El asistente usa el mismo contenido indexado que tu sitio de documentación desplegado.

Para verificar el estado de tu autenticación, ejecuta:

```bash
mint status
```

Para cerrar sesión, ejecuta:

```bash
mint logout
```

<div id="custom-ports">
  ## Puertos personalizados [#puertos-personalizados]
</div>

Por defecto, la CLI usa el puerto 3000. Para usar un puerto diferente, usa el flag `--port`:

```bash
mint dev --port 3333
```

Si el puerto ya está en uso, la CLI intenta automáticamente el siguiente puerto disponible.

<div id="skip-openapi-processing">
  ## Omitir el procesamiento de OpenAPI [#omitir-el-procesamiento-de-openapi]
</div>

Si tienes muchos archivos OpenAPI, omite el procesamiento de OpenAPI durante el desarrollo local para mejorar el rendimiento con el flag `--disable-openapi`:

```bash
mint dev --disable-openapi
```

<div id="disable-navigation-prefetching">
  ## Deshabilitar la precarga de navegación [#deshabilitar-la-precarga-de-navegación]
</div>

De forma predeterminada, la vista previa local precarga las páginas cercanas para que la navegación entre ellas se sienta instantánea. En sitios muy grandes, esto puede ralentizar la página que estás viendo, porque muchas páginas se compilan en segundo plano al mismo tiempo.

Si tienes miles de páginas y notas cargas de página lentas durante la vista previa local, deshabilita la precarga con el flag `--disable-prefetch`:

```bash
mint dev --disable-prefetch
```

Con la precarga deshabilitada, las páginas se compilan solo cuando navegas a ellas. Las cargas de página individuales tardan más que una página precargada, pero la página que solicitas no compite con la compilación en segundo plano.

<div id="preview-as-a-specific-group">
  ## Previsualizar como un grupo específico [#previsualizar-como-un-grupo-específico]
</div>

Si usas control de acceso basado en grupos, previsualiza como un grupo de autenticación específico con el flag `--groups`:

```bash
mint dev --groups admin
```

Consulta [Configuración de autenticación](/es/deploy/authentication-setup#control-access-with-groups) para más información sobre grupos.