Corregir el error "Must be a valid url" en logo.href o navbar.primary.href

Cuando ejecutas mint dev o mint validate con una ruta relativa como /contact en los campos logo.href, navbar.links[].href o navbar.primary.href de docs.json, una versión desactualizada de la CLI informa errores como estos:

🚨 Invalid docs.json:
#.logo.href: Must be a valid url
#.navbar.primary.href: Must be a valid url

Las versiones actuales de la CLI de Mintlify aceptan tanto URL absolutas como rutas relativas que comienzan con / en estos campos. Las rutas relativas mantienen los enlaces funcionando en despliegues de vista previa, dominios personalizados y vistas previas locales sin codificar tu dominio de producción.

Actualizar la CLI

Actualiza a la versión más reciente de la CLI:

mint update

Si mint update no está disponible en tu versión, reinstala la CLI. Consulta Instalar la CLI para ver los comandos de reinstalación. Luego comprueba tu versión y vuelve a ejecutar la validación:

mint version
mint validate

Configuración de ejemplo

docs.json

"logo": {
  "light": "/logo/light.svg",
  "dark": "/logo/dark.svg",
  "href": "/quickstart"
},
"navbar": {
  "links": [
    { "label": "Changelog", "href": "/changelog" }
  ],
  "primary": {
    "type": "button",
    "label": "Contact us",
    "href": "/contact"
  }
}

Las rutas relativas deben comenzar con /. Un valor como contact sin barra inicial sigue fallando la validación. Los tipos de botón github y discord siguen requiriendo una URL de repositorio de GitHub o una URL de invitación de Discord. Para ver la referencia completa de los campos, consulta logo y navbar.

Temas relacionados

Referencia de comandos de la CLI de Mintlify Navegación Solución de problemas

⌘I

​Actualizar la CLI

​Configuración de ejemplo

Actualizar la CLI

Configuración de ejemplo