Creating Your GitHub Account

GitHub is where you store and share your projects in the cloud. If you don't have an account yet, create one now:

  1. Go to github.com and click Sign up
  2. Fill in your email, password and choose a username
  3. Confirm the email sent to your inbox

Done. Now let's put your first project up there.

Setting Up Your SSH Key

An SSH key connects your computer to GitHub without needing to type a password every time. Set it up before creating your repository.

1. Generate the key

ssh-keygen -t ed25519 -C "your.email@example.com"

Press Enter on all prompts to use the default values.

2. Copy the public key

Linux/macOS:

cat ~/.ssh/id_ed25519.pub

Windows (PowerShell):

Get-Content ~/.ssh/id_ed25519.pub

3. Add it to GitHub

  1. Go to github.com/settings/keys
  2. Click New SSH key, paste the key and save

4. Test the connection

ssh -T git@github.com

If you see "Hi username! You've successfully authenticated", you're all set.

Your First Repository

A repository is your project folder with the full change history saved by Git. Let's create one from scratch and publish it on GitHub.

1. Create a folder and initialize Git

mkdir my-project
cd my-project
git init

2. Create a file

echo "# My Project" > README.md

3. Add and make your first commit

git add .
git commit -m "first commit"

4. Create the repository on GitHub

  1. Go to github.com/new
  2. Name the repository — use the same folder name: my-project
  3. Set it as Public and click Create repository
  4. Don't check any extra options (README, .gitignore, license) — the repository must be empty

5. Connect your local repo to GitHub and push

GitHub will show these commands after you create the repository. Copy and paste them in your terminal:

git remote add origin git@github.com:your-username/my-project.git
git push -u origin main

Replace your-username with your GitHub username.

Refresh the repository page on GitHub — your README.md will already be there. 🎉

Now that your first repository is live, feel free to explore other projects. Follow me on GitHub to see what I'm building: github.com/ecodelearn

Cloning an Existing Repository

To download a project that already exists on GitHub to your computer:

git clone git@github.com:username/repository.git

This creates a local folder with all the project content and history, ready for you to work on.

Support this project

Help keep this project online by making a donation.