Create a repo

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

Create a repository

You can store a variety of projects in GitHub AE repositories, including innersource projects. With innersource, you can share code to make better, more reliable software. For more information on innersource, see GitHub's white paper "An introduction to innersource."

  1. In the upper-right corner of any page, use the drop-down menu, and select New repository. Drop-down with option to create a new repository
  2. Type a short, memorable name for your repository. For example, "hello-world". Field for entering a repository name
  3. Optionally, add a description of your repository. For example, "My first repository on GitHub AE." Field for entering a repository description
  4. Choose a repository visibility. For more information, see "About repository visibility." Radio buttons to select repository visibility
  5. Select Initialize this repository with a README. Initialize this repository with a README checkbox
  6. Click Create repository. Button to create repository

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

Tip: You can also create repositories using the GitHub CLI. For more information, see "gh repo create" in the GitHub CLI documentation.

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.md. 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. 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." 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 the default branch, 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." Commit branch options
  8. Click Propose file change. Propose file change button

Celebrate

Congratulations! You have now created a repository, including a README file, and created your first commit on your enterprise.

You can now clone a GitHub AE repository to create a local copy on your computer. From your local repository you can commit, and create a pull request to update the changes in the upstream repository. For more information, see "Cloning a repository" and "Set up Git."

You can find interesting projects and repositories on GitHub AE and make changes to them by creating a fork of the repository. For more information see, "Fork a repository."

Each repository in GitHub AE is owned by a person or an organization. You can interact with the people, repositories, and organizations by connecting and following them on GitHub AE. For more information see "Be social."

GitHub AE has a great support community where you can ask for help and talk to people from around the world. Join the conversation on Github Support Community.

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Or, learn how to contribute.