Criar um repositório

Criar um repositório a partir da interface do usuário da web

1. Opcionalmente, para criar um repositório com a estrutura de diretório e os arquivos de um repositório existente, selecione o menu suspenso Escolher um modelo e clique em um repositório de modelo. Você verá repositórios de modelo que pertencem a você e às organizações das quais você é integrante ou que usou antes. Para saber mais, confira Criar um repositório a partir de um modelo.

2. Opcionalmente, se você escolheu usar um modelo para incluir a estrutura do diretório e os arquivos de todos os branches no modelo, não apenas o branch padrão, selecione Incluir todos os branches.

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

   

4. Digite um nome para o repositório (máximo de 100 caracteres) e uma descrição opcional.

   

5. Defina as propriedades personalizadas para a criação do repositório, se forem necessárias. Definir propriedades personalizadas pode afetar a validade do nome do repositório escolhido, além da visibilidade do repositório disponível. Para saber mais, confira Como gerenciar propriedades personalizadas para repositórios na sua organização.

          ![Captura de tela da seção "Propriedades necessárias" do formulário de criação do repositório mostrando as propriedades "produção" e "camada de segurança" com valores definidos.](/assets/images/help/repository/repos-create-properties.png)
   

6. Escolha uma visibilidade do repositório. Para saber mais, confira Sobre repositórios.

7. Se você não estiver usando um modelo, haverá um número de itens opcionais com os quais você pode preencher previamente o seu repositório. Se for importar um repositório existente para o GitHub, não escolha qualquer uma destas opções, pois isso poderá criar um conflito de merge. É possível adicionar ou criar arquivos usando a interface de usuário ou optar por adicionar novos arquivos posteriormente usando a linha de comando. Para saber mais, confira Como importar um repositório Git externo usando a linha de comando, Adicionar um arquivo a um repositório e Resolvendo conflitos de mesclagem.

   • Você pode criar um README, que é um documento que descreve seu projeto. Para saber mais, confira Sobre o arquivo README do repositório.
   • Você pode criar um arquivo .gitignore, que é um conjunto de regras a serem ignoradas. Para obter mais informações, confira Ignorar arquivos.
   • Você pode optar por adicionar uma licença de software para seu projeto. Para obter mais informações, consulte Licenciar um repositório.

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. Opcionalmente, se você tiver acesso a agente de codificação Copilot, insira um prompt para Copilot para usar no preenchimento do seu repositório. Após a criação do repositório, Copilot abrirá uma solicitação de pull request em rascunho, escreverá o código solicitado e, em seguida, solicitará sua revisão. Para saber mais, confira Sobre o agente de codificação do GitHub Copilot.

10. Clique em Criar repositório.

11. Na parte inferior da página Configuração rápida resultante, em "Import code from an old repository" (Importar código de um repositório antigo), você pode optar por importar um projeto para o novo repositório. Para fazer isso, clique em Importar código.

Criar um repositório a partir de uma consulta de URL

É possível usar parâmetros de consulta para preencher previamente os campos do formulário ao criar um repositório. Os parâmetros de consulta são partes opcionais de uma URL que podem ser personalizadas para compartilhar uma exibição de página web específica, como resultados do filtro de pesquisa ou um modelo de problemas no GitHub. Para especificar valores para os parâmetros de consulta predefinidos, é necessário corresponder ao par de chave e valor.

O preenchimento prévio de campos de formulário com uma consulta de URL pode ser útil se você deseja criar repositórios com as mesmas configurações padrão. Por exemplo, um professor pode querer que cada aluno de uma turma crie um repositório em sua conta pessoal com o mesmo nome, descrição e visibilidade. Usando uma consulta de URL, o professor pode criar um link que preencha previamente o nome do repositório, a descrição e os campos de visibilidade e compartilhá-lo com toda a turma.

Você deve ter as permissões adequadas para qualquer ação para usar o parâmetro de consulta equivalente. Por exemplo, é necessário ter permissão para criar um repositório em uma organização para especificar a organização como o proprietário do repositório em um parâmetro de consulta. Para saber mais, confira Funções de repositório para uma organização.

Se você criar um URL inválido usando parâmetros de consulta ou se não tiver as permissões adequadas, os parâmetros de consulta inválidos serão ignorados e o restante do URL funcionará normalmente. Se você criar uma URL que exceda o limite do servidor, a URL retornará uma página de erro 414 URI Too Long.

Parâmetro de consulta	Exemplo	Valores válidos
name

          `https://github.com/new?name=test-repo&owner=avocado-corp` cria um repositório chamado "test-repo" pertencente à organização "avocado-corp". | Qualquer nome de repositório válido. Os espaços devem ser substituídos por `+` ou `%20`. |

| description | O https://github.com/new?description=An+exciting+repository&visibility=private&owner=octocat cria um repositório com a descrição "Um repositório interessante" com visibilidade privada pertencente a @octocat. | Qualquer cadeia de caracteres. Os espaços devem ser substituídos por + ou %20. | | visibility | O https://github.com/new?visibility=private cria um repositório com visibilidade privada. | public
private
internal | | owner | O https://github.com/new?owner=avocado-corp&visibility=public cria um repositório público de propriedade da organização "avocado-corp". | Qualquer nome de organização ou nome de usuário válido. Como alternativa, enquanto estiver conectado, use @me para especificar sua conta de usuário como o proprietário. | | template_owner e template_name | O https://github.com/new?owner=avocado-corp&template_owner=avocado-corp&template_name=octo-repo cria um repositório pertencente à "avocado-corp" usando o template "octo-repo" da avocado-corp. | O nome de usuário do proprietário do modelo e o nome do modelo de repositório. |

Leitura adicional

•         [AUTOTITLE](/code-security/getting-started/quickstart-for-securing-your-repository)
  

•         [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories)
  

•         [Guias de Código Aberto](https://opensource.guide/)
  

•         [GitHub Skills](https://skills.github.com/)