{"meta":{"title":"Guia de início rápido para repositórios","intro":"Saiba como criar um novo repositório e realizar o seu primeiro commit em 5 minutos.","product":"Repositórios","breadcrumbs":[{"href":"/pt/repositories","title":"Repositórios"},{"href":"/pt/repositories/creating-and-managing-repositories","title":"Criar e gerenciar repositórios"},{"href":"/pt/repositories/creating-and-managing-repositories/quickstart-for-repositories","title":"Guia de início rápido para repositórios"}],"documentType":"article"},"body":"# Guia de início rápido para repositórios\n\nSaiba como criar um novo repositório e realizar o seu primeiro commit em 5 minutos.\n\n## Criar um repositório\n\nOs repositórios do GitHub armazenam uma variedade de projetos. Neste guia, você criará um repositório e fará commit da sua primeira alteração.\n\n\n\n\n\n> \\[!NOTE]\n> Para saber mais sobre GitHub CLI, confira [Sobre GitHub CLI](/pt/github-cli/github-cli/about-github-cli).\n\n1. Na linha de comando, acesse o diretório onde você gostaria de criar um clone local do seu novo projeto.\n2. Para criar um repositório para seu projeto, use o subcomando `gh repo create`. Quando solicitado, selecione **Crie um novo repositório no GitHub do zero** e insira o nome do novo projeto. Caso você deseje que o seu projeto pertença a uma organização em vez da sua conta pessoal, especifique o nome da organização e o nome do projeto com `organization-name/project-name`.\n3. Siga as instruções interativas. Para clonar o repositório localmente, marque sim quando perguntarem se você deseja clonar o diretório do projeto remoto.\n4. Como alternativa, para ignorar os prompts, forneça o nome do repositório e um sinalizador de visibilidade (`--public`, `--private` ou `--internal`). Por exemplo, `gh repo create project-name --public`. Para clonar o repositório localmente, transmita o sinalizador `--clone`. Para obter mais informações sobre possíveis argumentos, consulte o manual da CLI [GitHub](https://cli.github.com/manual/gh_repo_create).\n\n
\n\n## Fazer commit da primeira alteração\n\n\n\n\n\nAgora que você criou um projeto, você pode começar a fazer commit das alterações.\n\nOs arquivos *LEIAME* são um ótimo lugar para descrever o projeto com mais detalhes ou adicionar alguma documentação (por exemplo, como instalar ou usar o projeto). O conteúdo do arquivo *LEIAME* é mostrado automaticamente na página inicial do repositório. Siga estas etapas para adicionar um arquivo *README*.\n\n1. Na linha de comando, acesse o diretório raiz do seu novo projeto. (Esse diretório foi criado quando você executou o comando `gh repo create`).\n\n2. Crie um arquivo *README* com algumas informações sobre o projeto.\n\n ```shell\n echo \"info about this project\" >> README.md\n ```\n\n3. Insira `git status`. Você verá que há um arquivo `README.md` não rastreado.\n\n ```shell\n $ git status\n\n Untracked files:\n (use \"git add ...\" to include in what will be committed)\n README.md\n\n nothing added to commit but untracked files present (use \"git add\" to track)\n ```\n\n4. Stage e commit do arquivo.\n\n ```shell\n git add README.md && git commit -m \"Add README\"\n ```\n\n5. Faça push das alterações para seu branch.\n\n ```shell\n git push --set-upstream origin HEAD\n ```\n\n
\n\n## Próximas etapas\n\nVocê criou agora um repositório, incluindo um arquivo *README*, e fez seu primeiro commit no GitHub.\n\n\n\n* Você já pode clonar um repositório do GitHub para criar uma cópia local no computador. A partir do seu repositório local, você pode fazer commit e criar um pull request para atualizar as alterações no repositório upstream. Para saber mais, confira [Clonar um repositório](/pt/repositories/creating-and-managing-repositories/cloning-a-repository) e [Configurar o git](/pt/get-started/git-basics/set-up-git).\n\n
\n\n* Proteja seu repositório usando os recursos de segurança disponíveis do GitHub. Para saber mais, confira [Guia de Início rápido para proteger seu repositório](/pt/code-security/getting-started/quickstart-for-securing-your-repository).\n\n* Encontre projetos e repositórios interessantes no GitHub e faça alterações neles criando um fork do repositório. A bifurcação de um repositório permitirá que você faça alterações em outro repositório sem afetar o original. Para saber mais, confira [Criar fork de um repositório](/pt/pull-requests/how-tos/work-with-forks/fork-a-repo).\n\n* Cada repositório em GitHub pertence a uma pessoa ou a uma organização. Você pode interagir com as pessoas, repositórios e organizações conectando-se e seguindo-as.GitHub Para saber mais, confira [Descobrindo projetos no GitHub](/pt/get-started/exploring-projects-on-github/discovering-projects-on-github).\n\n* O GitHub tem uma ótima comunidade de suporte na qual você pode pedir ajuda e conversar com pessoas de todo o mundo. Participe da conversa na [GitHub Community](https://github.com/orgs/community/discussions)."}