> For the complete documentation index, see [llms.txt](https://cumbucadev.gitbook.io/github-essentials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cumbucadev.gitbook.io/github-essentials/dia-6/criando-um-repositorio-no-github.md).

# Criando um Repositório no GitHub

Chegou o momento de criar seu primeiro repositório no GitHub! Siga este passo a passo para criar o repositório e entender cada etapa do processo:

## **Passo 1: Acessar a página de criação de repositórios**

No canto superior direito de qualquer página, selecione e clique em New Repository (*Novo repositório*):

<figure><img src="/files/fWgxIUaSlhTDdvI98qM1" alt="Captura de tela do menu suspenso do GitHub, acessado pelo botão de &#x22;+&#x22;. As opções disponíveis no menu são: &#x22;New repository&#x22; (destacado), &#x22;Import repository&#x22;, &#x22;New codespace&#x22;, &#x22;New gist&#x22;, &#x22;New organization&#x22; e &#x22;New project&#x22;. No canto superior direito, o avatar do usuário está visível."><figcaption><p>Menu suspenso no GitHub exibindo opções para criar ou gerenciar novos recursos</p></figcaption></figure>

## **Passo 2: Preencher os campos do formulário**

1. **Repository name (nome do repositório):** hello-world

*Por que `hello-world`? Esse nome é uma tradição na programação e representa o primeiro passo ao aprender algo novo. Traduzido para o português, significa "olá, mundo". É como uma introdução ao mundo da tecnologia e uma forma de testar que tudo está funcionando. Para saber mais sobre a história e o significado por trás do "Olá, Mundo", confira o blog post* [*Olá, Mundo!*](https://cumbuca.dev/2024/09/27/ola-mundo/) *no site da Cumbuca Dev.*

2. **Description (descrição):** Meu primeiro repositório no GitHub

*Essa descrição ajuda outras pessoas (ou até você mesmo no futuro) a entender rapidamente o objetivo do projeto.*

3. **Selecione a opção Public (público)**

*Tornar o repositório público significa que qualquer pessoa poderá acessá-lo e visualizá-lo. Isso é ótimo para projetos iniciais ou se você quiser compartilhar com a comunidade.*

4. **Selecione a opção Add a README file (Adicionar um arquivo README)**

*O `README` é um dos arquivos mais importantes de qualquer repositório. Ele funciona como a página inicial do seu projeto, explicando o que é, como usá-lo e outras informações úteis.*\
*Ao selecionar esta opção, o GitHub criará um `README` básico para você automaticamente. Ele pode ser editado depois para incluir detalhes mais completos sobre o seu projeto.*

5. **Não altere mais nada**

Para este primeiro repositório, as configurações padrão já são suficientes.

<figure><img src="/files/I1VIFosP96oZP50C6r5q" alt="Captura de tela da página de criação de um novo repositório no GitHub. O proprietário do repositório é &#x22;aprendizCumbucaDev&#x22;, e o nome do repositório escolhido é &#x22;hello-world&#x22;, indicado como disponível. A descrição do repositório é &#x22;Meu primeiro repositório no GitHub&#x22;. A opção &#x22;Public&#x22; está selecionada, e a caixa para adicionar um arquivo README está marcada. As opções para adicionar um .gitignore e escolher uma licença estão disponíveis, mas não foram selecionadas. A mensagem informa que a branch padrão será &#x22;main&#x22;. O botão &#x22;Create repository&#x22; aparece no canto inferior direito."><figcaption><p>Tela de configuração inicial para criar um repositório no GitHub</p></figcaption></figure>

## **Passo 3: Criar o repositório**

Clique no botão **Create Repository (Criar repositório)**.

## Passo 4: Verificar o resultado

Após criar o repositório, você verá uma nova página com detalhes do projeto.&#x20;

<figure><img src="/files/NxtOVm7Idov3oFqNJi6G" alt="Captura de tela de um repositório no GitHub chamado &#x22;hello-world&#x22;, pertencente ao usuário &#x22;aprendizCumbucaDev&#x22;. O repositório contém um arquivo README.md com o título &#x22;hello-world&#x22; e a descrição &#x22;Meu primeiro repositório no GitHub&#x22;. O repositório está na branch &#x22;main&#x22; e possui um único commit intitulado &#x22;Initial commit&#x22;. No lado direito, há informações como 0 estrelas, 1 observador e 0 forks."><figcaption><p>Repositório hello-world</p></figcaption></figure>

Parabéns, você deu o primeiro passo na sua jornada no GitHub! 🎉 Nosso próximo passo é explorar um pouco deste novo repositório criado.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cumbucadev.gitbook.io/github-essentials/dia-6/criando-um-repositorio-no-github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.