Perguntas frequentes
Dúvidas comuns sobre o Jamdesk: preços, tempos de build, domínios personalizados, colaboração em equipe, chat com IA, integração com GitHub e recursos do site de documentação.
Dúvidas comuns sobre preços, builds, domínios e recursos.
As capturas de tela mostram a interface em inglês.
Primeiros passos
O Jamdesk é uma plataforma de documentação que gera sites de docs a partir dos seus arquivos Markdown. Escreva em MDX e envie para o GitHub. Seu site é publicado com busca, análise e um arquivo llms.txt para ferramentas de IA.
Não. MDX é texto simples com formatação básica. Os componentes são opcionais.
Sim. Oferecemos um teste gratuito de 14 dias com todos os recursos.
Sua documentação são arquivos MDX simples em um repositório do GitHub, e não fica presa a um editor proprietário. Ao enviar para o GitHub, seu site é publicado em menos de 60 segundos. Não é preciso configurar build nem pipeline de CI/CD. Todo site recebe llms.txt e um servidor MCP. Ferramentas de IA como Claude e ChatGPT podem ler sua documentação atual diretamente. Os visitantes têm um assistente de chat com IA integrado que responde perguntas com base na sua documentação.
Builds e implantação
A maioria dos sites de documentação é gerada em 30 a 60 segundos. Sites maiores, com muitas páginas, podem levar mais tempo.
Sim. Visualize localmente com hot reload usando a CLI do Jamdesk (jamdesk dev). As alterações só vão ao ar quando você envia para o GitHub ou executa jamdesk deploy.
Sim. Execute jamdesk deploy no diretório do seu projeto. A CLI empacota e envia seus arquivos e depois dispara um build. Não é necessário um repositório Git. Veja o guia de deploy da CLI para mais detalhes.
Um push para o branch do GitHub conectado. Você também pode disparar um build pelo dashboard ou com jamdesk deploy na CLI.
Sim. Acesse Deployments no seu projeto. Encontre o build anterior e clique em Rollback.
Cobrança e preços
O plano Pro custa US$ 29/mês e inclui um projeto de documentação. Cada projeto adicional custa US$ 15/mês. Veja Planos e preços para mais detalhes.
Não. Oferecemos um teste gratuito de 14 dias. Depois disso, é necessária uma assinatura Pro.
Aceitamos cartões de crédito Visa, Mastercard, American Express e Discover.
Oferecemos reembolso em até 30 dias após o primeiro pagamento. Entre em contato com o suporte para solicitar.
Domínios personalizados
Sim. Adicione um domínio personalizado em Settings → Domains. O Jamdesk provisiona o certificado SSL.
Geralmente algumas horas. Pode levar até 48 horas.
Sim. Use um proxy reverso (Cloudflare, AWS, nginx) para servir o Jamdesk em um subcaminho. Veja Hospedagem em subcaminho.
Equipes e colaboração
Abra seu projeto e acesse Settings → Members. Digite o e-mail da pessoa no campo Invite Member e clique em Invite. Ela receberá um e-mail com um link para entrar no projeto.

Os convidados precisam de uma conta no Jamdesk. O convite pede que criem uma caso não tenham. Já é membro, mas o link de convite diz que "já foi aceito"? Faça login. Você voltará ao projeto. Veja Membros da equipe para funções e limites de membros.
Ilimitados, em todos os planos, sem custo extra.
Os membros da equipe podem visualizar builds e disparar novas gerações. A edição acontece no seu repositório do GitHub. Quem tem acesso ao repositório pode editar a documentação.
Acesse Settings → Members. Clique em Transfer Ownership ao lado do membro que você quer promover. O novo proprietário precisa ser um membro existente da equipe.
CLI
Em ~/.jamdeskrc, um arquivo JSON com permissões 0600 (apenas o seu usuário pode lê-lo). Ele armazena seu refresh token, e-mail e ID de usuário. Execute jamdesk logout para limpá-lo.
Seu refresh token não é mais válido. Isso acontece após alterações de senha, exclusão de conta ou inatividade prolongada. Execute jamdesk login para obter uma nova sessão.
Sim. O login pelo navegador não funciona em ambientes headless. Faça login na sua máquina local. Copie ~/.jamdeskrc para o seu runner de CI. O refresh token autentica a partir daí.
Execute jamdesk fix. Ele corrige links internos quebrados que têm um único destino correto (âncoras com erro de digitação e desvio de âncora entre locales). Ele edita seus arquivos .mdx locais após uma pré-visualização. Veja antes as alterações planejadas com jamdesk fix --dry-run. Ele só altera links cuja âncora corrigida é um cabeçalho real. Casos ambíguos ficam para revisão manual. Veja Corrigir links quebrados automaticamente.
Conteúdo e recursos
Arquivos MDX (Markdown + JSX) e Markdown padrão.
Sim. Defina componentes inline no MDX com export const, ou crie componentes reutilizáveis no diretório /snippets. Para componentes interativos com hooks, use arquivos .tsx com 'use client'. Veja Componentes React personalizados e Snippets.
Não há limite fixo. Sites com centenas de páginas são gerados e funcionam normalmente.
Sim. Adicione um seletor de idioma com a propriedade languages na configuração de navegação. Cada idioma tem sua própria estrutura de navegação e conteúdo. Veja Suporte a vários idiomas.
Não. Você fornece os arquivos MDX traduzidos. O Jamdesk cuida do roteamento, da navegação, do seletor de idioma e da estilização RTL. Use traduções do seu próprio fluxo de trabalho (tradutores humanos, tradução automática ou um LLM). Coloque-as em diretórios com prefixo de idioma (es/, fr/ etc.). Veja Suporte a vários idiomas para a estrutura de diretórios e a configuração.
Chat com IA
Sim. Todo site do Jamdesk inclui um assistente de chat integrado que responde às perguntas dos visitantes com base na sua documentação. Ele vem ativado por padrão. Veja Chat com IA para detalhes.
Não. O chat com IA está incluído em todos os planos.
Sim. Defina chat.enabled como false no seu docs.json:
{ "chat": { "enabled": false } }Seu próximo build remove o painel de chat e o atalho de teclado.
Somente as páginas da sua documentação publicada. Cada build indexa seu conteúdo em um banco de dados vetorial. O Jamdesk recupera as seções relevantes para a pergunta do visitante e as envia ao Claude como contexto. A IA não tem acesso a dados fora da sua documentação.
Privacidade e acesso
Sim. Marque páginas internas com private: true no frontmatter, ou liste os caminhos delas em auth.password.private[] no docs.json. Páginas privadas exibem uma tela de desbloqueio. Todas as páginas ficam em um só projeto, com um repositório e um build. Veja Controle de acesso e Proteção por senha.
Defina auth.password.enabled: true no docs.json e envie a alteração. Defina uma senha em Project Settings → Password Protection no dashboard. Os visitantes veem uma tela de desbloqueio até informá-la. Veja Proteção por senha.
Sim, nos planos Enterprise. O Single Sign-On permite que os leitores se autentiquem no seu provedor de identidade (Okta, Google Workspace, Azure AD etc.), sem senhas compartilhadas, com trilha de auditoria completa e desprovisionamento imediato. Veja SSO ou entre em contato com o time de vendas Enterprise.
Geralmente não. Use um projeto com private: true nas páginas internas. Você mantém um repositório e um dashboard. Use dois projetos apenas quando os públicos precisarem de marcas, domínios personalizados ou análises separados. Veja Controle de acesso para os padrões.
Editores escrevem a documentação enviando MDX para o repositório do GitHub conectado. Um push só gera build se quem enviou for membro do projeto Jamdesk ou uma conta de automação autorizada por você. Leitores visualizam o site publicado: todos (público), quem tiver a senha (modo senha) ou quem fizer login pelo seu IdP (SSO). Membros da equipe do dashboard controlam builds, análises e configurações. A participação também permite que os pushes deles gerem build. Veja Controle de acesso.
