Solución de problemas

Empieza aquí cuando algo no funcione. Cada sección incluye una solución rápida y un enlace a la guía completa en el Centro de ayuda.

Fallos de build

El dashboard muestra un build como "Failed". La mayoría de los fallos provienen de una de estas tres causas: una página MDX con una importación o un componente inválido, una edición incorrecta de docs.json (corchetes sin cerrar, comas al final del último elemento de un array) o una página incluida en la navegación de docs.json que no existe como archivo .mdx. Los dos primeros aparecen localmente con jamdesk dev antes de llegar a un build desplegado. Ejecutarlo una vez antes de hacer push suele ahorrar un ciclo innecesario.

Para códigos de error específicos, consulta Fallos de build y la Referencia de errores.

Dominio personalizado sin verificar

¿El dominio se queda en "Pending" después de añadir los registros DNS? Revisa estos pasos en orden:

1. Confirma que añadiste el registro TXT _jamdesk.<hostname>. El enrutamiento no se activa sin él, y la falta del TXT es la causa más habitual de un dominio en Pending. El hostname es el dominio completo que estás verificando (para docs.example.com, el nombre del registro TXT es _jamdesk.docs.example.com).
2. Confirma que añadiste un registro CNAME (no un registro A) para los subdominios.
3. Si usas Cloudflare, configura el proxy en modo DNS only (nube gris) para ambos registros.
4. Comprueba la propagación en whatsmydns.net.

# Verify the TXT verification record
dig TXT _jamdesk.docs.yourdomain.com

# Verify your CNAME is resolving
dig CNAME docs.yourdomain.com

Hay algo que conviene saber y no es evidente: incluso después de que dig muestre tus registros resolviendo, el dashboard puede seguir mostrando "Pending" hasta 30 minutos. El verificador se encuentra detrás de resolvers upstream que cachean respuestas DNS negativas, y esa ventana de caché debe expirar antes de que una nueva verificación tenga éxito. Si todo resuelve localmente pero el dashboard no se ha actualizado, espera media hora antes de asumir un problema más profundo.

Solución de problemas de DNS cubre los casos particulares de cada proveedor.

Repositorio de GitHub no aparece

Si tu repositorio no aparece en la lista al crear un proyecto, es probable que la aplicación GitHub de Jamdesk no esté instalada en la organización del repositorio, o que el acceso esté configurado como "Selected repositories" sin incluir el tuyo. Vuelve a autorizar en github.com/settings/installations y concede acceso a "All repositories" o al repositorio específico que necesitas.

Consulta Problemas con GitHub para problemas de Webhook y permisos.

Datos de analítica faltantes

Algunas razones habituales por las que el dashboard muestra cero visitantes. La analítica puede tardar hasta 24 horas en aparecer tras el primer despliegue de un sitio, por lo que los proyectos nuevos parecen vacíos durante un tiempo. Los bloqueadores de anuncios y la opción "Do Not Track" impiden que una parte de las visitas se contabilice; tus cifras siempre serán menores que las de tus logs del servidor. Si ninguna de estas causas aplica, confirma que tu sitio esté efectivamente desplegado y sea accesible públicamente.

Problemas de analítica profundiza en los datos retrasados o faltantes.

Problemas de inicio de sesión

¿No puedes iniciar sesión o te redirige de vuelta a la pantalla de login? Borra la caché y las cookies de dashboard.jamdesk.com y prueba en una ventana de incógnito. Si inicias sesión con GitHub, tu correo de GitHub debe coincidir con el correo de tu cuenta de Jamdesk.

Consulta Problemas de inicio de sesión para los pasos de recuperación de cuenta.

¿Sigues sin poder resolverlo?