A beginner's guide to managing Git repos without breaking your brain
This guide is written for solo developers working independently with Git. If you're working in a team or contributing to shared repositories, some practices may differ. We cover team workflows in Part 7.
What Is GitHub Desktop (And Why Use It)?
Let's face it, not everyone loves the command line. GitHub Desktop is the visual, beginner-friendly way to manage Git without memorizing cryptic syntax.
Why use it?
- It's free and works on Windows and macOS
- You can commit, push, pull, and branch with a few clicks
- Helps you visualize your version history and changes
- Syncs perfectly with your GitHub account
- Great if you're pairing with AI tools or just starting out
There's no Linux version of GitHub Desktop. If you're on Linux, check out Part 4: Git from the Command Line instead.
Installing GitHub Desktop
- Go to https://desktop.github.com
- Download for your OS
- Install and launch the app
- Sign in using your GitHub account credentials
Do this after you've set up your first repo on GitHub. If you haven't, go read Part 1 first.
Cloning a Repository
To bring your GitHub repo to your machine:
- Open GitHub Desktop
- Go to
File > Clone repository - Select one of your repos or paste the repo URL
- Choose a local folder path (don't just dump it on your desktop)
Now you've got a live copy of your repo on your machine.
Making Changes and Committing
- Open the repo folder in your favorite code or text editor
- Make a small change (edit the README, add a file, etc.)
- Flip back to GitHub Desktop, it will detect the change
- Write a commit message:
- Summary = short title
- Description = optional details
- Click Commit to main
Commit messages are like notes to your future self. Be kind to future-you.
Pushing to GitHub
Once you commit locally, it's time to sync:
- Click Push origin
- Your changes will upload to GitHub.com
- Confirm by visiting your repo in the browser
Remember: Local changes stay local until you push.
Pulling Changes from GitHub
If you:
- Switched devices
- Made changes directly on GitHub
- Collaborated with someone else
You'll want to pull before working.
- Click Fetch origin
- Then click Pull origin
- GitHub Desktop will update your local copy
If there are conflicts, it will notify you. Don't panic, we cover conflict resolution in Part 7.
Branching for the Brave
A branch is like a parallel universe of your project where you can experiment safely.
- Click Current Branch > New Branch
- Name your branch (e.g.,
feature-idea) - Do your edits, commit normally
- When ready, merge back to
main(manual or via Pull Request on GitHub.com)
No need to fear branches. They're how real work gets done without wrecking the main build. We go deeper on branching in Part 3.
Tips, Traps, and Good Habits
- Always pull before you push
- Commit often, with clear messages
- Don't commit files that belong in
.gitignore(node_modules,.env, etc.) - Broke something? Use history to revert commits
- Organize your local repos, don't scatter them
Final Thoughts
GitHub Desktop is perfect for beginners, writers, designers, and anyone who wants Git without terminal anxiety.
Ready to give it a shot?
Download GitHub Desktop