Create a repo in githup

Set up Git

At the heart of GitHub is an open source version control system (VCS) called Git. Git is responsible for everything GitHub-related that happens locally on your computer.

In this article

• Setting up Git
• Next steps: Authenticating with GitHub from Git
• Celebrate

To use Git on the command line, you'll need to download, install, and configure Git on your computer.

If you want to work with Git locally, but don't want to use the command line, you can instead download and install the GitHub Desktop client. For more information, see "Getting started with GitHub Desktop."

If you don't need to work with files locally, GitHub lets you complete many Git-related actions directly in the browser, including:

• Creating a repository
• Forking a repository
• Managing files
• Being social

 

Create a repo

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

In this article

• Commit your first change
• Celebrate

You can store a variety of projects in GitHub repositories, including open source projects. With open source projects, you can share code to make better, more reliable software.

 

Note: You can create public repositories for an open source project. When creating your public repository, make sure to include a license file that determines how you want your project to be shared with others. For more information on open source, specifically how to create and grow an open source project, we've created Open Source Guides that will help you foster a healthy open source community by recommending best practices for creating and maintaining repositories for your open source project. You can also take a free GitHub Learning Lab course on maintaining open source communities.

1. In the upper-right corner of any page, use the  drop-down menu, and select New repository.

Type a short, memorable name for your repository. For example, "hello-world".

 

 

 

Optionally, add a description of your repository. For example, "My first repository on GitHub."

 

 

Choose a repository visbility. For more information, see "About repository visibility."

Select Initialize this repository with a README.

 

 

1. Click Create repository.

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.

 

In your repository's list of files, click README.md.

 

 

1. Above the file's content, click .

2. On the Edit file tab, type some information about yourself.

Above the new content, click Preview changes.

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

 

1. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file. You can attribute the commit to more than one author in the commit message. For more information, see "Creating a commit with multiple co-authors."

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. For more information, see "Creating a new pull request."

 

 

 

Click Propose file change.

 

 

Celebrate

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?

• "Set up Git"
• Create a repository
• "Fork a repository"
• "Be social"
• Connect with people around the world in the GitHub Community Forum