Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Criar um repositório a partir de um modelo

Você pode gerar um novo repositório com os mesmos arquivos e estrutura de diretório de um repositório que já existe.

Sobre modelos de repositório

Qualquer pessoa com permissões de leitura em um repositório de modelos pode criar um repositório a partir desse modelo. Para obter mais informações, confira "Criar um repositório de modelos".

Dica: você também pode criar um repositório com base em um modelo usando a GitHub CLI. Para obter mais informações, confira "gh repo create" na documentação da GitHub CLI.

Você pode optar por incluir a estrutura do diretório e os arquivos apenas a partir do branch-padrão do repositório de modelos ou incluir todos os branches. Os branches criados a partir de um modelo têm histórico não relacionado, o que significa que você não pode criar pull requests ou fazer merge entre os branches.

Criar um repositório a partir de um modelo é semelhante a bifurcar um repositório, mas há diferenças importantes:

  • Uma nova bifurcação inclui o histórico de commits inteiro do repositório principal, enquanto um repositório criado de um modelo começa com um único commit.
  • Os commits em uma bifurcação não aparecem no gráfico de contribuições, enquanto os commits em um repositório criado de um modelo aparecem no gráfico de contribuição.
  • Uma bifurcação pode ser uma maneira temporária de contribuir com código em um projeto existente, enquanto criar um repositório de um modelo inicia um novo projeto rapidamente.

Para obter mais informações sobre forks, confira "Sobre bifurcações".

Criar um repositório a partir de um modelo

  1. No GitHub.com, navegue até a página principal do repositório.

  2. Acima da lista de arquivos, selecione Usar este modelo.

  3. Selecione Criar um repositório.

    Usar este botão de modelo

    Nota: como alternativa, é possível abrir o modelo em um codespace e publicar seu trabalho posteriormente em um novo repositório. Para obter mais informações, confira "Como criar um codespace com base em um modelo".

    1. Use o menu suspenso **Proprietário** e selecione a conta que você deseja que seja proprietária do repositório. ![Menu suspenso Proprietário](/assets/images/help/repository/create-repository-owner.png) 1. Digite um nome para o seu repositório e uma descrição opcional. ![Campo Criar repositório](/assets/images/help/repository/create-repository-name.png) 1. Escolha uma visibilidade do repositório. Para obter mais informações, confira "[AUTOTITLE](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)". ![Botões de opção usados para selecionar a visibilidade do repositório](/assets/images/help/repository/create-repository-public-private.png)
  4. Opcionalmente, para incluir a estrutura de diretório e os arquivos de todos os branches no modelo e não apenas o branch padrão, selecione Incluir todos os branches. Caixas de seleção Incluir todos os branches

  5. Opcionalmente, se a conta pessoal ou de organização na qual você está criando usar GitHub Apps do GitHub Marketplace, selecione os aplicativos que deseja usar no repositório. Lista de GitHub Apps da sua conta do GitHub Marketplace e opção usada para permitir acesso

  6. Clique em Criar repositório do modelo.