A beginner-friendly guide to setting up GitHub, your first repo, and a proper README
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.
Whether you're starting from scratch or just tired of pretending to understand GitHub during meetings, this guide is your new best friend. We'll walk through how to set up a GitHub account, spin up your first repository, toss in a proper .gitignore, and drop a high-level README that doesn't suck.
Why GitHub, Though?
- It's where your code lives online.
- It makes collaboration easy.
- It's basically a resume for devs.
- Version control saves your butt (often).
No command line skills required here. Just a browser and a pulse.
Step 1: Create Your GitHub Account
- Go to https://github.com.
- Click Sign up in the top right.
- Fill in:
- Email address
- Username
- Password
- Verify your account and pick a plan (free is fine).
- Confirm your email.
Done? Great. You now have a seat at the dev table.
Step 2: Create Your First Repository
- After login, click the + icon in the upper-right > New repository.
- Name it something meaningful, e.g.,
my-first-project. - Set visibility:
- Public: Share with the world.
- Private: Keep it to yourself (for now).
- Check the box to initialize with a README.
- Add a
.gitignorefile (see next section). - Choose a License (MIT is a safe bet for beginners).
- Click Create repository.
.gitignore: What It Is and Why It Matters
A .gitignore file tells Git what not to track (like node_modules/, .env, system files, etc.). This keeps your repo clean and professional.
How to add it (from the web):
- During repo creation, choose a preset based on your language (e.g., Python, C++, Unity).
- You can always add or edit it later.
Example for Python:
__pycache__/
*.py[cod]
.env
README: Your Project's Front Door
You already added a basic one when setting up the repo, but don't stop there. Your README should:
- Explain what the project is.
- Say why it exists.
- Help others get started.
A good README turns a random repo into something people actually want to look at. Take the time to write one that makes sense.
Final Thoughts
You've now:
- Claimed your GitHub presence.
- Created your first repo.
- Avoided
.gitignoreshame. - Added a non-cringe README.
That's a solid start. You're officially more legit than 80% of "aspiring devs" on TikTok.
Next up? We'll tackle GitHub Desktop and syncing projects.
Until then, keep poking around and don't break anything. (Or do, just use version control.)