---
title: Preview Local
description: El CLI de Jamdesk permite hacer preview de tu documentación en tu máquina antes de desplegar. Los cambios aparecen al instante mientras editas.
---

Ejecuta `jamdesk dev` (o `npx jamdesk dev`) desde cualquier directorio que contenga un `docs.json` para iniciar un servidor local con hot reload, búsqueda completa y todos los componentes funcionando exactamente igual que en producción.

## Requisitos previos

Antes de comenzar, asegúrate de tener:

- **Node.js 20+** - Compruébalo con `node --version`
- **Un proyecto de documentación** - Con un archivo de configuración `docs.json`

## Iniciar el servidor de desarrollo

<Tabs>
  <Tab title="npm (Instalación global)">
    Instala el CLI globalmente y luego ejecútalo desde el directorio de tu documentación:

    ```bash
    npm install -g jamdesk
    cd your-docs
    jamdesk dev
    ```
  </Tab>
  <Tab title="npx (Sin instalación)">
    Ejecútalo directamente sin instalar:

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

Tu documentación estará disponible en **http://localhost:3000**

## Qué obtienes

<Columns cols={2}>
  <Card title="Hot Reload" icon="bolt">
    Edita archivos MDX y ve los cambios al instante. Los cambios en docs.json y en tu `style.css` se aplican al actualizar.
  </Card>
  <Card title="Búsqueda completa" icon="magnifying-glass">
    Prueba la búsqueda Cmd+K con tu contenido real
  </Card>
  <Card title="Todos los componentes" icon="puzzle-piece">
    Cada componente funciona exactamente igual que en producción
  </Card>
  <Card title="Cambio de tema" icon="moon">
    Prueba los modos claro y oscuro
  </Card>
</Columns>

## Puerto personalizado

El puerto predeterminado es 3000. Si está en uso, especifica uno diferente:

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

O establece un valor predeterminado permanente en `~/.jamdeskrc`:

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

## Modo detallado

Consulta información detallada del build con el flag `--verbose`:

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

Esto muestra:
- Detección de cambios en archivos
- Tiempos del build
- Análisis de navegación
- Advertencias o errores

## Rendimiento en la primera ejecución

<Note>
La primera vez que ejecutas `jamdesk dev`, instala dependencias en `~/.jamdesk`. Esto tarda entre 30 y 60 segundos. Las ejecuciones posteriores inician en menos de 5 segundos.
</Note>

Para limpiar la caché y forzar una instalación nueva:

```bash
jamdesk clean
jamdesk dev
```

## Solución de problemas

<AccordionGroup>
  <Accordion title="Puerto ya en uso">
    Otro proceso está usando el puerto 3000.

    **Opción 1:** Usa un puerto diferente
    ```bash
    jamdesk dev --port 3001
    ```

    **Opción 2:** Encuentra y detén el proceso
    ```bash
    lsof -i :3000
    kill -9 <PID>
    ```
  </Accordion>

  <Accordion title="docs.json no encontrado">
    Asegúrate de estar en el directorio que contiene tu archivo `docs.json`:

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

  <Accordion title="Los cambios no aparecen">
    Prueba estos pasos:
    1. Comprueba el terminal en busca de errores
    2. Recarga forzada del navegador (Cmd+Shift+R)
    3. Reinicia el servidor de desarrollo
    4. Ejecuta `jamdesk clean` e inténtalo de nuevo
  </Accordion>

  <Accordion title="Inicio lento">
    Ejecuta diagnósticos:
    ```bash
    jamdesk doctor
    ```

    Esto comprueba tu entorno e identifica problemas.
  </Accordion>
</AccordionGroup>

## ¿Qué sigue?

<Columns cols={2}>
  <Card title="Extensión de VS Code" icon="window" href="/es/development/vscode-extension">
    Inicia el servidor de desarrollo desde la barra de estado de VS Code
  </Card>
  <Card title="Despliegue" icon="rocket" href="/es/development/deployment">
    Aprende sobre el proceso de build y despliegue
  </Card>
</Columns>