---
title: Visão geral da configuração
sidebarTitle: Visão geral da configuração
description: >-
  Crie um projeto, conecte o GitHub, organize seu repositório e defina quem pode ler sua documentação. Comece aqui antes de publicar o site.
---

> **For AI agents:** the complete documentation index is at [llms.txt](/docs/llms.txt). Append `.md` to any page URL for its markdown version.

Todo site Jamdesk começa da mesma forma: um projeto no dashboard, um repositório do GitHub por trás dele e um arquivo `docs.json` que descreve sua navegação. Esta seção aborda essa configuração inicial, além das decisões estruturais que vale a pena tomar desde o início. É muito mais fácil definir o layout das URLs, os idiomas e o controle de acesso antes de ter cinquenta páginas do que depois.

Migrando de outra plataforma? Vá direto para o [Guia de migração](/pt/setup/migration). O Jamdesk pode automatizar a maior parte da conversão.

## Do repositório ao site publicado

<Steps>
  <Step title="Crie um projeto">
    Comece com um modelo ou conecte um repositório existente do GitHub. Seu site ficará disponível em `yourproject.jamdesk.app`.
  </Step>
  <Step title="Conecte o GitHub">
    Instale o aplicativo do GitHub para que cada push faça o deploy automaticamente.
  </Step>
  <Step title="Organize o repositório">
    Um arquivo `docs.json` e páginas MDX. Esse é todo o contrato.
  </Step>
</Steps>

## Configuração principal

<Columns cols={3}>
  <Card title="Criar um projeto" icon="rocket" href="/pt/setup/creating-projects">
    De um modelo ou repositório existente a um site publicado
  </Card>
  <Card title="Conectar o GitHub" icon="github" href="/pt/setup/connecting-github">
    Instalação do aplicativo, acesso ao repositório e deploys automáticos a cada push
  </Card>
  <Card title="Estrutura de diretórios" icon="folder-tree" href="/pt/setup/directory-structure">
    Arquivos obrigatórios, diretórios de páginas, imagens e snippets
  </Card>
  <Card title="Guia de migração" icon="truck-moving" href="/pt/setup/migration">
    Migre de outra plataforma de documentação, de forma automatizada ou manual
  </Card>
  <Card title="Suporte a monorepo" icon="boxes-stacked" href="/pt/setup/monorepo-support">
    Mantenha a documentação junto do código quando ela não estiver na raiz do repositório
  </Card>
  <Card title="Suporte a vários idiomas" icon="language" href="/pt/setup/languages">
    Disponibilize a documentação em vários idiomas com um seletor de idioma
  </Card>
</Columns>

## Estrutura do site

<Columns cols={2}>
  <Card title="Navegação" icon="sitemap" href="/pt/navigation/overview">
    Abas, grupos e páginas que organizam sua documentação
  </Card>
  <Card title="Redirecionamentos" icon="arrows-turn-right" href="/pt/setup/redirects">
    Redirecionamentos exatos e baseados em padrões para páginas movidas ou renomeadas
  </Card>
</Columns>

## Privacidade e acesso

<Columns cols={3}>
  <Card title="Controle de acesso" icon="shield-halved" href="/pt/setup/access-control">
    Totalmente público, protegido por senha, misto ou SSO. Compare as opções.
  </Card>
  <Card title="Proteção por senha" icon="lock" href="/pt/setup/password-protection">
    Bloqueie todo o site ou apenas algumas páginas com uma senha compartilhada
  </Card>
  <Card title="Login único (SSO)" icon="key" href="/pt/setup/sso">
    SAML ou OIDC por meio do seu provedor de identidade
  </Card>
</Columns>