Creating a repository for your project on GitHub

In this tutorial, you'll create the repository you'll use throughout this series. You'll build a small software project called stargazers-log. By the end of the journey, you'll plan work, write code, review changes, and deploy your code to a live website.

stargazers-log is a simple website that tracks and displays repositories you have starred. It helps you build a personal catalog of tools and code examples you care about. Starring repositories also helps you bookmark projects for later and show appreciation to maintainers.

Примечание.

As you follow this series, if you use GitHub Enterprise Cloud с размещением данных or GitHub Enterprise Server, you will need to substitute references and links to GitHub.com with your enterprise's dedicated URL.

Prerequisites

An account on GitHub. To sign up, go to https://github.com/signup.

What is a repository?

A repository is where you keep code and files for a software project on GitHub. It stores your files, tracks each change as a commit, and gives collaborators a shared place to work. Most software projects—from a single web page to a large application—live in their own repository.

Creating your repository

Follow these steps to create the repository for this series.

In the upper-right corner of any page on GitHub, select , then click New repository.

Alternatively, go to new repository page on GitHub.com to open the new repository form directly.
Use the Owner dropdown menu to select your personal account to own the repository.
In the Repository name field, type stargazers-log.
In the Description field, type a short description, such as "A log of the repositories I've starred."
Use the Choose visibility dropdown menu to select Public so you can publish your software project to a live site later in this series.
Select Add README. This gives your repository a starting file and a place to describe your software project.
You do not need to add a .gitignore or license file for this software project, so leave those options unchanged.
Click Create repository.

Adding a starter web page

Your software project will grow into a small web page, so add an index.html file to hold its content.

On the main page of your stargazers-log repository above the list of files, click , then click Create new file.
In the file name field, type index.html.

In the file editor, add the following starter content.

HTML

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Stargazers log</title>
  </head>
  <body>
    <h1>Stargazers log</h1>
    <p>A log of the repositories I've starred.</p>
  </body>
</html>

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Stargazers log</title>
  </head>
  <body>
    <h1>Stargazers log</h1>
    <p>A log of the repositories I've starred.</p>
  </body>
</html>

Click Commit changes.
In the dialog that opens, keep the default option to commit directly to the main branch, then click Commit changes.

What you accomplished

Task	Outcome
Created a repository	You created `stargazers-log` to store your software project on GitHub.
Added a README	You gave your software project a place to describe itself.
Added a web page	You created `index.html` as the starting point for your site.

Next steps

Now that your software project has a home, plan the work you want to do. Continue to Planning your work.