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, consulte "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.

    Captura de tela do botão "Usar este modelo" e do menu suspenso expandido para mostrar a opção "Abrir em um codespace".

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

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

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

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

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

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

  9. Clique em Criar repositório do modelo.