GitHub Account and Repository
Creating a GitHub Account
To use GitHub, a free account is needed. GitHub offers free accounts with unlimited public and private repositories.
Step 1 — Sign Up
- Go to https://github.com
- Click "Sign up"
- Enter an email address
- Create a strong password
- Choose a unique username — this will be part of a public profile URL like
github.com/username - Complete the CAPTCHA verification
- Verify the email address by clicking the link sent to the inbox
Choosing a Username
The GitHub username appears on all contributions, pull requests, and the public profile. Choose a username that is professional, easy to remember, and ideally matches other professional profiles. Avoid usernames with random numbers unless necessary.
GitHub Account Plans
| Plan | Cost | Features |
|---|---|---|
| Free | $0/month | Unlimited public and private repos, basic Actions, GitHub Pages |
| Pro | $4/month | Advanced insights, more Actions minutes, protected branches |
| Team | $4/user/month | Collaboration tools for organizations |
| Enterprise | $21/user/month | Advanced security, compliance, and admin features |
The free plan is sufficient for most individual developers and learners.
Setting Up a Profile
After signing in, the profile can be customized at github.com/username:
- Add a profile photo
- Write a short bio
- Add a location and website URL
- Pin important repositories to the profile
- Create a special README file for the profile (by creating a repo with the same name as the username)
Creating a New Repository on GitHub
Method 1 — Using the GitHub Website
- Log in to GitHub
- Click the "+" icon in the top-right corner
- Select "New repository"
- Fill in the details:
- Repository name — Keep it lowercase, use hyphens instead of spaces (e.g.,
my-portfolio) - Description — Optional but recommended
- Visibility — Public (anyone can see) or Private (only invited people)
- Initialize repository — Optionally add a README, .gitignore, and license
- Repository name — Keep it lowercase, use hyphens instead of spaces (e.g.,
- Click "Create repository"
Repository Initialization Options Explained
| Option | What it Does | When to Use |
|---|---|---|
| Add a README | Creates a README.md file describing the project | Always recommended — provides a homepage for the repo |
| Add .gitignore | Creates a .gitignore based on the chosen language | Use when starting a project from GitHub |
| Choose a license | Adds an open-source license (MIT, Apache, etc.) | Use for public projects to define usage rights |
Understanding the Repository Page
After creating the repository, the main page has several key sections:
- Code tab — Browse all files and folders in the repository
- Issues tab — Bug reports and feature requests
- Pull Requests tab — Pending code changes for review
- Actions tab — Automated workflows (CI/CD)
- Settings tab — Repository settings, collaborators, and more
- Clone/Code button — The HTTPS or SSH URL used to clone the repo locally
Writing a Good README.md
The README.md file is the first thing people see when visiting a repository. A good README should include:
# Project Name
A short description of what the project does.
## How to Install
Steps to set up the project locally.
## How to Use
Example usage and commands.
## Technologies Used
List of tools, languages, and frameworks used.
## Contributing
Instructions for contributing to the project.
## License
MIT License
Deleting or Renaming a Repository
To rename or delete a repository:
- Open the repository on GitHub
- Go to Settings (last tab on the repository page)
- To rename: Change the name in the "Repository name" field and click "Rename"
- To delete: Scroll to the "Danger Zone" section at the bottom and click "Delete this repository"
Warning: Deleting a repository is permanent and cannot be undone. Always make sure a local backup exists before deleting.
Summary
Creating a GitHub account is free and straightforward. A repository on GitHub is the online home for a project — it can be public or private. The README.md file serves as the project's homepage and description. After creating a repository on GitHub, the next step is connecting it to a local Git repository using git remote and git push.