> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ark-dev.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Development

> Previsualiza cambios localmente para actualizar tus docs

<Info>
  **Requisitos**:

  * Node.js 19 o superior
  * Un repositorio con un archivo `docs.json`
</Info>

Sigue estos pasos para instalar y ejecutar Mintlify en tu sistema.

<Steps>
  <Step title="Instalar Mintlify CLI">
    ```bash theme={"dark"}
    npm i -g mint
    ```
  </Step>

  <Step title="Previsualizar en local">
    Navega a la carpeta de docs donde está tu `docs.json` y ejecuta:

    ```bash theme={"dark"}
    mint dev
    ```

    La vista previa local estará disponible en `http://localhost:3000`.
  </Step>
</Steps>

## Puertos personalizados

Por defecto, Mintlify usa el puerto 3000. Puedes cambiarlo con `--port`. Por ejemplo, para usar el 3333:

```bash theme={"dark"}
mint dev --port 3333
```

Si el puerto está ocupado, usará el siguiente disponible:

```md theme={"dark"}
Port 3000 is already in use. Trying 3001 instead.
```

## Versiones de Mintlify

Cada release del CLI se asocia a una versión de Mintlify. Si la vista local no coincide con producción, actualiza el CLI:

```bash theme={"dark"}
npm mint update
```

## Validación de links

El CLI permite validar enlaces. Para detectar links rotos:

```bash theme={"dark"}
mint broken-links
```

## Deployment

Si el deployment es exitoso, deberías ver algo similar:

<Frame>
  <img src="https://mintcdn.com/arkdev/waOe3NwzRlaDq_kP/images/checks-passed.png?fit=max&auto=format&n=waOe3NwzRlaDq_kP&q=85&s=a7703cfec56a6ccae66fce5a0ef940d4" alt="Screenshot of a deployment confirmation message that says All checks have passed." style={{ borderRadius: '0.5rem' }} width="1100" height="346" data-path="images/checks-passed.png" />
</Frame>

## Formato de código

Sugerimos extensiones para reconocer y formatear MDX. En VSCode puedes usar [MDX VSCode extension](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx) y [Prettier](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Error: Could not load the &#x22;sharp&#x22; module using the darwin-arm64 runtime">
    Esto puede deberse a una versión antigua de Node. Prueba lo siguiente:

    1. Elimina el CLI actual: `npm remove -g mint`
    2. Actualiza a Node v19 o superior.
    3. Reinstala el CLI: `npm i -g mint`
  </Accordion>

  <Accordion title="Issue: Encountering an unknown error">
    Solución: elimina la carpeta `~/.mintlify` y ejecuta `mint dev` nuevamente.
  </Accordion>
</AccordionGroup>

¿Quieres ver cambios recientes del CLI? Revisa el [changelog](https://www.npmjs.com/package/mintlify?activeTab=versions).