To put your project up on GitHub, you'll need a repository for it to live in. Let's create one!

On GitHub, you can store all kinds of projects in repositories. Personal repositories belong to user accounts, so after you've signed up for GitHub, you can create your first repository!

Create a new repository on GitHub

  1. In the upper-right corner of any page, click , and then click New repository. New repository menu

  2. Create a short, memorable name for your repository. For example, "hello-world". Repository name field

  3. Optionally, add a description of your repository. For example, "My first repository on GitHub." Repository description
  4. Choose between creating a public or private repository.
    • Public repositories are a great choice for getting started! They're visible to any user on GitHub, so you can benefit from a collaborative community.
    • Private repositories require a little more setup. They're only available to you, the repository owner, as well as any collaborators you choose to share with. Private repositories are only available for paid accounts. For more information, see "What plan should I choose?." Public and private repository options
  5. Select Initialize this repository with a README. Initialize with a readme checkbox
  6. Click Create repository. Create repository button

Congratulations! You've successfully created your first repository, and initialized it with a README file.

Commit your first change

A commit is like a snapshot of all the files in your project at a particular point in time.

When you created your new repository, you initialized it with a README file. README files are a great place to describe your project in more detail, or add some documentation such as how to install or use your project. The contents of your README file are automatically shown on the front page of your repository.

Let's commit a change to the README file.

  1. In your repository's list of files, click Readme file in file list
  2. Above the file's content, click .
  3. On the Edit file tab , type some information about yourself. New content in file
  4. Above the new content, click Preview changes. File preview button

  5. Review the changes you made to the file. You'll see the new content in green. File preview view

  6. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. Commit message for your change

  7. Below the commit message fields, decide whether to add your commit to the current branch or to a new branch. If your current branch is master, you should choose to create a new branch for your commit and then create a pull request. Commit branch options

  8. Click Propose file change. Propose file change button


Congratulations! You have now created a repository, including a README file, and created your first commit on GitHub. What do you want to do next?