Preguntas frecuentes

Jamdesk es una plataforma de documentación que construye sitios de docs a partir de tus archivos Markdown. Escribe en MDX, sube los cambios a GitHub, y tu sitio se despliega automáticamente con búsqueda, analítica y llms.txt listo para IA.

No se requieren conocimientos de programación. Escribir en MDX es como usar un editor de texto: escribes texto plano con formato sencillo. Los componentes están disponibles si los quieres, pero son completamente opcionales.

¡Sí! Ofrecemos un periodo de prueba gratuito de 14 días con acceso completo a todas las funcionalidades.

Jamdesk está construido sobre MDX y GitHub: tus docs son archivos de texto plano en un repositorio, no están encerrados en un editor propietario. Sube los cambios a GitHub y tu sitio se despliega en menos de 60 segundos sin configuración de build ni pipeline de CI/CD. Cada sitio recibe automáticamente llms.txt y un servidor MCP, para que herramientas de IA como Claude y ChatGPT puedan acceder directamente a tus docs actuales. Los visitantes también disponen de un asistente de chat con IA integrado que responde preguntas a partir de tu documentación.

La mayoría de los sitios de documentación se construyen en 30-60 segundos. Los sitios más grandes con muchas páginas pueden tardar más.

¡Sí! Usa el CLI de Jamdesk (jamdesk dev) para previsualizar localmente con hot reload. Los cambios solo se publican cuando subes a GitHub o ejecutas jamdesk deploy.

Sí. Ejecuta jamdesk deploy desde el directorio de tu proyecto. El CLI empaqueta tus archivos, los sube y lanza un build directamente. No se requiere repositorio Git. Consulta la guía de CLI Deploy para más detalles.

Los builds se lanzan automáticamente al hacer push a tu rama de GitHub conectada. También puedes lanzarlos manualmente desde el dashboard o con jamdesk deploy desde el CLI.

Sí. Ve a Deployments en tu proyecto, encuentra el build anterior y haz clic en Rollback.

El plan Pro cuesta $29/mes por proyecto. Los proyectos adicionales son $15/mes cada uno. Consulta Planes y precios para más detalles.

Ofrecemos un periodo de prueba gratuito de 14 días. Después necesitarás una suscripción Pro para continuar.

Aceptamos tarjetas de crédito Visa, Mastercard, American Express y Discover.

Ofrecemos reembolsos dentro de los 30 días posteriores a tu primer pago. Contacta con soporte para recibir ayuda.

¡Sí! Añade un dominio personalizado en Settings → Domains. Los certificados SSL se aprovisionan automáticamente.

Los cambios de DNS suelen propagarse en pocas horas, pero pueden tardar hasta 48 horas.

Sí. Usa un proxy inverso (Cloudflare, AWS, nginx) para servir Jamdesk en una subruta. Consulta Subpath Hosting.

Abre tu proyecto, ve a Settings → Members, escribe el correo electrónico de la persona en el campo Invite Member y haz clic en Invite. Recibirá un correo con un enlace para unirse al proyecto.

Los usuarios invitados necesitan una cuenta de Jamdesk; si no tienen una, se les pedirá que la creen al aceptar la invitación. ¿Ya eres miembro pero el enlace de invitación dice que «ya ha sido aceptado»? No necesitas una nueva invitación. Solo tienes que iniciar sesión y volverás al proyecto. Consulta Miembros del equipo para ver roles y límites de miembros.

Los planes Pro incluyen 10 miembros del equipo por proyecto.

Los miembros del equipo pueden ver los builds y lanzar reconstrucciones, pero la edición se realiza en tu repositorio de GitHub. Cualquier persona con acceso al repositorio puede editar los docs.

Ve a Settings → Members y haz clic en Transfer Ownership junto al miembro al que quieres promocionar. El nuevo propietario debe ser ya un miembro del equipo.

En ~/.jamdeskrc, un archivo JSON con permisos 0600 (solo tu usuario puede leerlo). Almacena tu token de actualización, correo electrónico e ID de usuario. Ejecuta jamdesk logout para borrarlo.

Tu token de actualización ya no es válido. Esto ocurre después de cambios de contraseña, eliminaciones de cuenta o inactividad prolongada. Ejecuta jamdesk login para obtener una sesión nueva.

Sí, pero el inicio de sesión basado en navegador no funcionará en entornos sin interfaz gráfica. Inicia sesión en tu máquina local y luego copia ~/.jamdeskrc a tu runner de CI. El token de actualización gestionará la autenticación desde ahí.

Jamdesk admite MDX (Markdown + JSX) y archivos Markdown estándar.

Sí. Define componentes inline directamente en MDX con export const, o crea componentes reutilizables en el directorio /snippets. Para componentes interactivos con hooks, usa archivos .tsx con 'use client'. Consulta Componentes React personalizados y Snippets.

No hay un límite estricto de páginas. La mayoría de los sitios de documentación funcionan bien con cientos de páginas.

Sí. Usa la propiedad languages en la configuración de navegación para crear un selector de idioma. Cada idioma tiene su propia estructura de navegación y contenido. Consulta Soporte multilingüe.

No. Jamdesk no traduce el contenido por ti. Tú proporcionas los archivos MDX traducidos y Jamdesk se encarga del enrutamiento, la navegación, el selector de idioma y los estilos RTL. Aporta las traducciones desde tu propio flujo de trabajo (traductores humanos, traducción automática o un LLM) y colócalas en directorios con prefijo de idioma (es/, fr/, etc.). Consulta Soporte multilingüe para la estructura de directorios y la configuración.

Sí. Cada sitio de Jamdesk incluye un asistente de chat integrado que responde las preguntas de los visitantes a partir de tu documentación. Está habilitado por defecto, sin necesidad de configuración. Consulta Chat con IA para más detalles.

No. El chat con IA está incluido en todos los planes sin coste adicional.

Sí. Establece chat.enabled en false en tu docs.json:

{ "chat": { "enabled": false } }

El panel de chat y el atajo de teclado se eliminarán después de tu próximo build.

El chat solo utiliza las páginas de documentación publicadas. Durante cada build, Jamdesk indexa tu contenido en una base de datos vectorial. Cuando un visitante hace una pregunta, se recuperan las secciones relevantes y se envían a Claude como contexto. La IA no puede acceder a datos fuera de tus docs.

Sí. Marca las páginas internas con private: true en el frontmatter, o lista sus rutas en auth.password.private[] en docs.json. Las páginas públicas permanecen públicas; las privadas muestran una pantalla de desbloqueo. Un proyecto, un repositorio, un build. Consulta Control de acceso y Protección con contraseña.

Establece auth.password.enabled: true en docs.json, sube el cambio y luego establece una contraseña en Project Settings → Password Protection en el dashboard. Cada visitante verá una pantalla de desbloqueo hasta que la introduzca. Consulta Protección con contraseña.

Sí, en los planes Enterprise. Single Sign-On permite a los lectores autenticarse contra tu proveedor de identidad (Okta, Google Workspace, Azure AD, etc.) sin contraseñas compartidas, con un registro de auditoría completo y desaprovisionamiento instantáneo. Consulta SSO o contacta con ventas Enterprise.

Normalmente no. Un único proyecto con private: true en las páginas internas es más sencillo: mismo repositorio, mismo build, un dashboard. Usa dos proyectos solo cuando las audiencias necesiten branding completamente separado, dominios personalizados o analítica diferenciada. Consulta Control de acceso para ver los patrones.

Los editores escriben los docs confirmando MDX en tu repositorio de GitHub conectado, por lo que cualquier persona con acceso de push a tu rama de docs puede publicar un cambio. Los lectores ven el sitio publicado: todo el mundo (público), cualquiera con la contraseña (modo contraseña) o cualquiera que haya iniciado sesión a través de tu IdP (SSO). Los miembros del equipo en el dashboard son un concepto aparte: gestionan builds y analítica pero no crean contenido directamente. Consulta Control de acceso.