Skip to main content

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.

Quem pode usar esse recurso?

Anyone with read access to a template repository can create a repository from that template.

Sobre modelos de repositório

Você pode criar um modelo a partir de um repositório existente. Qualquer pessoa com acesso ao repositório de modelos pode criar um novo repositório baseado no modelo com a mesma estrutura de diretórios, branchs e arquivos. Para obter mais informações sobre a criação de um modelo de repositório, confira Criar um repositório de modelos.

Tip

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. Em GitHub, acesse a página principal do repositório.

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

  3. Use o menu suspenso Proprietário para selecionar a conta que deseja atribuir como proprietário do repositório.

    Captura de tela do menu Proprietário de um novo repositório do GitHub. O menu mostra duas opções, octocat e github.

  4. Digite um nome para o seu repositório e uma descrição opcional.

    Captura de tela da primeira etapa na criação de um repositório do GitHub. O campo "Nome do repositório" contém o texto "hello-world" e está contornado em laranja escuro.

  5. Escolha uma visibilidade do repositório. Para obter mais informações, confira "Sobre repositórios".

  6. 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.

  7. Clique em Criar repositório do modelo.